Browse
Playgrounds
Info
About How to publish FAQ
Log in
Terms Privacy
Publisher guide

How to
publish

Get your Swift Playground books and apps listed on Swiftgrounds in four steps.

Swiftgrounds works by reading a JSON feed you host on your own domain. You stay in control of your content, and Swiftgrounds just makes it discoverable. Here’s how to get set up.

1
Create an account
Sign up with a username and email. Your username becomes your public profile URL at swiftgrounds.dev/u/username. You can change your username once every 30 days, so choose something you’re happy with.
2
Add and verify your domain
In Account settings, add the domain where you’ll host your feed (e.g. yoursite.com). Swiftgrounds will give you a unique verification code. Prove ownership by adding a meta tag to your homepage or a text file at /.well-known/swiftgrounds-verification.txt. Once verified, the domain is linked to your account permanently, or until you remove it. Your feed must be hosted on this verified domain.
3
Write your feed JSON
Create a .json file on your domain that describes your playground books. The format follows Apple’s original subscription feed schema. Each entry needs a title, subtitle, description, content identifier, version, and download URL. You can also include thumbnail images, preview images, difficulty level, and publish dates.

See the full schema and a complete example in the FAQ → Feed format.
4
Submit your feed URL
Go to the Feed page in your account and paste the URL to your JSON file. Swiftgrounds will fetch it immediately, parse the entries, and list them in the index. When you update your feed, hit Refresh to sync the latest version. That’s it, your playgrounds are live.

Tips

  • Use thumbnailURL images at 902×678px for the best card appearance in Swiftgrounds and Swift Playgrounds.
  • Set difficultyLevel to beginner, intermediate, advanced, or expert. This drives the filter chips in the index.
  • If you use GitHub Pages, add an empty .nojekyll file to the repo root so the .well-known folder is served correctly.
  • The feed URL must remain accessible and return valid JSON at all times. Broken feeds are flagged and may be hidden from the index.

Questions?

The FAQ covers the full feed format, localization, domain verification, and more.

Ready to get started?
Create your account and submit your feed in minutes.
Create account