> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skybridge.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Starter

> The default app scaffolded by `npm create skybridge`. A guided onboarding tour through Skybridge's core APIs.

The Starter is what `npm create skybridge` scaffolds. It's a short, interactive onboarding deck featuring the Skybridge mascot and a swappable hat. The deck walks new users through Skybridge's core primitives: reading tool output, sharing view state with the model, and triggering tools from the view.

Get me started with Skybridge.

Starter

![Skybridge Starter](https://docs.skybridge.tech/images/showcase-starter.png)

> [card] [View source](https://github.com/alpic-ai/apps-sdk-template)
>
> Browse the example code.

## What it demonstrates

The Starter registers two tools on the server and a single view that walks through four steps:

* **`start`**: opens the onboarding view, with an optional `name` input the view reads back to greet the user.
* **`get-fortune-cookie`**: a plain tool the view calls on demand to fetch a random prediction.

Each step of the deck highlights one Skybridge API:

1. **Reading tool output**: the view hydrates with the `name` passed to `start`.
2. **Sharing view state**: clicking "Change my hat" updates persisted view state and surfaces the current hat to the model via `data-llm`.
3. **Calling tools**: the view invokes `get-fortune-cookie` from a button and renders the result.
4. **Examples & docs**: outro linking to further reading.

## Skybridge APIs used

* [`useToolInfo`](https://docs.skybridge.tech/api-reference/use-tool-info): read the input and output of the tool that opened the view.
* [`useViewState`](https://docs.skybridge.tech/api-reference/use-view-state): persist UI state on the host and expose it to the model.
* [`useCallTool`](https://docs.skybridge.tech/api-reference/use-call-tool): invoke a server tool from within the view.
* [`useUser`](https://docs.skybridge.tech/api-reference/use-user): read the host theme and locale.
* [`data-llm`](https://docs.skybridge.tech/api-reference/data-llm): describe what the user sees so the model can collaborate.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.