# Presets

Nine finished islands built on the engine, one file each. Install one as it is, or read it for technique and build your own.

> For the full documentation index, see [llms.txt](https://islandcn.dev/llms.txt). Every page has a Markdown version: add `.md` to its URL or send `Accept: text/markdown`. To build an island, follow the islandcn agent skill at https://islandcn.dev/.well-known/agent-skills/islandcn/SKILL.md.

Pick a preset when your task matches one of these closely. When it doesn't, build your island on the engine and open the closest preset to see how it lays out the compact slots, which shape it alerts into, and how it drives a ring from state.

| Preset | Registry item | What it shows |
| --- | --- | --- |
| [Upload](/docs/presets/upload) | `upload-activity` | A photo or file upload: the thumbnail, a ring with the percentage, and a check when it lands |
| [Timer](/docs/presets/timer) | `timer-activity` | A countdown with the time left, and pause and cancel buttons when expanded |
| [Now playing](/docs/presets/now-playing) | `now-playing-activity` | Artwork, a live level meter, and transport controls when expanded |
| [Incoming call](/docs/presets/incoming-call) | `call-activity` | A caller with accept and decline buttons while it rings, then a call timer |
| [Ride or delivery ETA](/docs/presets/eta) | `eta-activity` | Minutes until a ride or delivery arrives, with the driver and an optional Message button |
| [Recording](/docs/presets/recording) | `recording-activity` | A recording dot, an elapsed timer and a level meter |
| [Nearby transfer](/docs/presets/transfer) | `nearby-transfer-activity` | A photo or file going to a device nearby, or coming from it, with a stop button |
| [Battery](/docs/presets/battery) | `battery-activity` | Charge level and charging state, shown briefly |
| [Split](/docs/presets/split) | `split-demo` | Two activities at once, attached pill and capsule |

## Every preset page has the same parts

- **Install:** the one command that adds it.
- **What it shows:** compact, split, expanded and how it updates.
- **Usage:** a component you can paste.
- **Props:** every prop with its default.

## What the presets share

Every preset depends on `island-content`, the kit the presets share. The shadcn CLI installs it, and `island-core`, with the first preset you add. It holds:

- `theme.ts`: the colours and type sizes.
- `glyphs.tsx`: islandcn's own glyph set, original drawings at the weight of system glyphs.
- `Glyph` and `IconTile`: size a glyph to the pill or a label, or set it on a round marker such as the ride's car. Both also take an icon from another set, such as Phosphor, when the glyph set doesn't draw the shape you need.
- `island-text.tsx`: the compact and expanded text styles.
- `useActivity`: binds an activity to a component's lifetime.

The other kit pieces (rings, bars, steps, sparklines, readings, clocks, buttons, artwork) are one registry item each. [Content kit](/docs/api/content-kit) lists them all, with what each is for.

Every preset is a component: render one while the task runs, and the activity starts on mount, follows its props and ends on unmount.

See them all running in the [playground](https://islandcn.dev/playground), where you can change what each region shows and copy the code.