Tutorials are for learning by building. Each one walks a fixed path from an empty directory to a running application — no step skipped, every rung proven by a real command or endpoint. You don't need to understand the whole framework before you start; each track introduces its capabilities in the order you'd actually reach for them.
Unlike the how-to guides, which assume you already know the shape of the task, a tutorial follows one continuous example and never leaves you guessing what to do next.
Five tracks, five applications
There are five independent tracks. Each builds one complete application from a
fresh netscript init, and each ends by running that application locally
under .NET Aspire — so whichever you pick, you finish with something that boots,
serves, and survives a restart. The tracks don't depend on each other; start with
the one closest to what you're building.
Not sure which to pick?
| Name | Type | Description |
|---|---|---|
An API with multi-step business logic |
Storefront |
You need typed services and a workflow that can't half-complete — orders, payments, fulfillment. Teaches contracts, defineService, sagas, and webhooks. |
An app behind a login |
Team Workspace |
You need authentication, sessions, and route-level access control before anything else. Teaches the auth backend, session crypto, and the .withAuthz() seam. |
Data pipelines and scheduled work |
ERP Sync |
Your work happens off the request path — file ingestion, batch jobs, scheduled syncs, and tasks in other languages. Teaches triggers, jobs, queues, cron, and the task runtime. |
A live, reactive frontend |
Live Dashboard |
You're rendering server data in a Fresh UI that stays current without a refresh. Teaches the SDK client, cache-first queries, the page builder, islands, and durable streams. |
A durable AI chat app |
AI Chat |
You're building a chat UI whose transcript, streaming markdown, tool-call cards, and MCP widgets survive reload and reconnect, with replies that stream in live. Teaches the durable chat route on @netscript/fresh/ai, the fresh-ui chat components, a server-side tool, the MCP client stack, and the live subscription. |
New to NetScript entirely? Any track starts from zero, but Storefront is the broadest tour of the core ideas — to inspect the whole shape of a NetScript backend, start there.
Before you start
Every track assumes a working local toolchain. If you have never run NetScript on this machine, the quickstart installs the CLI and gets a project up in a few commands; each track's first chapter then re-grounds you from the scaffold, so you can start in either place.
When you finish
Once you've completed a track, branch out into the rest of the docs: