---
title: Playground Books
framework: Swift Playgrounds
role: collectionGroup
path: swift-playgrounds/playground-books
---

# Playground Books

Create interactive Playground Book based learning experiences for the Swift Playgrounds app.

## Overview

Overview You may create content for the Swift Playgrounds app by writing playground books. Like traditional books, playground books are made up of chapters and pages. Unlike traditional books, they include executable Swift code that displays the results live, right on the page. The pages of a playground book can include features that you use to teach a lesson or to encourage code experimentation. The basic building blocks you use are: Prose that introduces the material on the page. Blocks and modules of Swift code that learners can edit and expand upon. The always-on live view that you use to show visualizations of running the page’s code. The following screenshot of a page from Learn to Code 1 shows a lesson on the left and an interactive live view on the right.

You can further enrich a playground book and tailor it to your audience by adding cutscenes, glossaries, hints, and assessments. When you’re done writing a playground book, you can distribute it locally in a classroom or workshop environment, or publish it online as a subscription.

## Topics

### Playground Setup

- [Creating and Running a Playground Book](swift-playgrounds/creating-and-running-a-playground-book.md)
- [Structuring Content for Swift Playgrounds](swift-playgrounds/structuring-content-for-swift-playgrounds.md)

### Annotations

- [Writing Prose for a Playground Page](swift-playgrounds/writing-prose-for-a-playground-page.md)
- [Specifying Editable Regions in a Playground Page](swift-playgrounds/specifying-editable-regions-in-a-playground-page.md)
- [Hiding Code from a Playground Page](swift-playgrounds/hiding-code-from-a-playground-page.md)
- [Customizing the Completions in the Shortcut Bar](swift-playgrounds/customizing-the-completions-in-the-shortcut-bar.md)
- [Localizing Code Comments and String Literals](swift-playgrounds/localizing-code-comments-and-string-literals.md)

### Glossaries

- [Adding a Glossary to a Playground Book](swift-playgrounds/adding-a-glossary-to-a-playground-book.md)

### Hints

- [Giving hints to help learners solve problems](swift-playgrounds/giving-hints-to-help-learners-solve-problems.md)

## See Also

### Related Documentation

- [Playground Bluetooth](playgroundbluetooth.md)
- [Playground Support](playgroundsupport.md)
