Skip to main content

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.

Ready? Step 1: Scaffold →