Documentation/Learn/Overview
In this section

Tutorial — from zero to deployed

A pragmatic 6-step walkthrough. Each step adds one layer of the stack and ends with a working artefact you can commit.

By the end you'll have:

  • A Titan backend with auth + database.

  • A React + Prism + netron-react frontend.

  • Tests across unit / integration / E2E.

  • A production-ready Docker deploy.

The steps

StepWhat you buildTime
1. ScaffoldEmpty monorepo → first Titan app saying hello10 min
2. ServiceA typed RPC service backed by a real database20 min
3. AuthJWT sign-in, sessions, role-gated methods25 min
4. FrontendReact + Prism + netron-react UI calling your service30 min
5. TestsUnit / module / integration / E2E coverage25 min
6. DeployDocker Compose stack to a server30 min

Total: ~2.5 hours from cold start.

Conventions

  • Code blocks are runnable as-is. Copy and replace placeholders marked <like this>.

  • Each step starts from where the previous one ended.

  • The final code lives at apps/api/ + apps/web/ in your monorepo.

Prerequisites

  • Node.js 22+

  • pnpm 9+

  • Docker (for the deploy step)

  • A code editor (VS Code recommended for TypeScript)

What this tutorial assumes you know

  • TypeScript at the level of "I've shipped a real app".

  • React at the level of "useState + useEffect".

  • A bit of SQL.

  • Git basics.

What you don't need:

  • DI experience (we'll introduce as needed).

  • RPC frameworks (Netron will explain itself).

  • Decorators (TypeScript-level, picked up by example).

When you're done

You'll know how to:

  • Define a Titan service and expose it over Netron.

  • Use the DI container effectively.

  • Wire authentication + RLS.

  • Build a React UI with end-to-end types.

  • Test at every layer.

  • Ship to production.

Then deepen with the reference docs — every module, every API, every recipe.