Skip to main content
Alpha

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.

Four tracks, four applications

There are four 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?

Choose by what you're building
NameTypeDescription
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.

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: