Guides

Step by step, from an empty folder to an app in production, on the web, on phones and on desktops. For one package in depth, open its page under Packages.

Build an app

Start from an empty folder and finish with a working app, its data, its sign-in and its updates.

Build a dashboard on an existing APIA signed-in admin app with a sortable, paged table and a create form, against a backend you already have.Build a full-stack appOne codebase with server-rendered pages, a database, server actions, a public API and live updates.Build an API server without ReactA JSON API with controllers, validation, a database, auth, realtime events, OpenAPI and a typed client, and no React anywhere.Add sign-in, end to endUsers, password sign-in, cookie sessions, guarded pages, sessions in server actions and API routes, and permissions checked the same way in the browser and on the server.Add live updatesPush changes from the server to every open screen over typed channels, so lists and details update without a reload.

Organise, test and deploy

Keep the app tested, put it in production, and grow from one app to several.

Test your appA test suite for a kitr app, from permission rules to a real browser, with a test database and a CI workflow that runs it on every push.Deploy to productionBuild a kitr app, set its environment, run migrations and ship it as static files, one Node process, a Docker image or a Cloudflare Worker.Run on more than one instancePut every piece of state a kitr app keeps in memory into Redis and object storage, so two or twenty instances behind a load balancer behave like one.Keep several apps in one repositoryA pnpm workspace with a web app, an API server, a shared package of schemas and types, and a private kitr package, all checked and tested together.

Ship to phones and desktops

The same app as an iPhone and Android app, a desktop app, or all of them from one project.

Build a phone appShip an iPhone and Android app from the same React code as your web app, with native navigation, sign-in that survives restarts, the share sheet and deep links.Build a desktop appTurn your React app into a Windows, macOS and Linux app with Electron, a list beside the detail, a real app menu, native save dialogs over typed IPC, and signed installers.Ship one app to the web, phones and desktopsOne kitr project that builds a web app, an iPhone and Android app and a desktop app from one route table, with per-platform pages, layouts and behaviour where they differ.

Extend and migrate

Write your own kitr package, or bring an existing app over.

Create a packageWrite a kitr package that `kitr add` installs and wires, with a config file, a container service, a CLI command, a generator, doctor checks and docs.Migrate from Next.jsMove a Next.js App Router project to kitr page by page, with a map from every Next.js concept to its kitr equivalent.