Getting started

AkurAI/Framework is a single-binary, pure-Rust web framework. There is nothing to install beyond the binary itself — no language runtime, no package manager, no build step.

Create a project

akurai new myapp
cd myapp
akurai serve

akurai serve starts the server on http://localhost:8090. Open it and you'll see the starter page, rendered server-side and pinging the health endpoint from the client.

Project layout

A new project is three folders and a config file:

myapp/
  frontend/        native-ESM pages, templates, and static assets
  backend/         page.json (context) + collections.toml (data model)
  data/            the database file and uploads (created at runtime)
  akurai.toml      host, port, paths

The core idea

The browser does the rendering; the server stays lean. Pages are server-rendered from templates against a JSON context, static assets are served as-is, and the data API is generated from your schema. There is no JavaScript build step — the browser loads native ES modules directly.

Data lives in the runtime store and in backend/page.json. You change content by editing files or writing to the database — never by recompiling the binary.

Next steps