Server running

backend is up.

You have a database, migrations, an admin, a REST API and an OpenAPI browser — wired and running. There are 0 published posts.

Open the admin Build your first app →

What is already wired

ORM & models

Post is declared in src/main.rs. Change it, then run makemigrations.

Migrations

Autodetected from your models. The declare → migrate → change → migrate loop is the whole product.

Admin

CRUD for every registered model at /admin/. Run createsuperuser to get in.

REST API

JSON CRUD + filtering at /api/post. Try ?published=true.

Auth & sessions

Users, password hashing, sessions, CSRF. The endpoints are ours; the pages are yours.

Plugins

Everything above is a plugin. So is the app you are about to write — umbral startapp blog.

next steps

  1. 1

    umbral startapp blog

    Add your first app — models, routes and templates of its own.

  2. 2

    cargo run -- makemigrations && cargo run -- migrate

    Declare a model, then let the engine write the schema.

  3. 3

    cargo run -- createsuperuser

    Then log in at /admin/.

Editing templates? Rebuild the CSS with cd styles && npm install && npm run build. Full guide: Your first app →