AkurAI-Framework / site/backend/page.json

Latest change b34c72a614f00efd0c0d58bdc5e3ccc63f07c682 - docs: fix stale info (v0.1.0 status, roadmap, crate table) + file remaining-feature batch ledger (BATCHES.md) by Ólafur Búi Ólafsson

{
  "site_url": "https://akurai-framework.olibuijr.com",
  "title": "AkurAI/Framework — a single-binary, pure-Rust web framework",
  "description": "A pure-Rust web framework: embedded database, auto-generated APIs, server-side templates, and built-in semantic search — in one static binary with no runtime dependencies and no build step.",
  "version": "v0.1.0",
  "year": 2026,
  "nav": [
    { "label": "Docs", "href": "/docs" },
    { "label": "Components", "href": "/components" },
    { "label": "Realtime", "href": "/realtime" },
    { "label": "Reactivity", "href": "/reactivity" },
    { "label": "Islands", "href": "/islands" },
    { "label": "Guestbook", "href": "/guestbook" },
    { "label": "Login", "href": "/login" },
    { "label": "Changelog", "href": "/changelog" },
    { "label": "GitHub", "href": "https://github.com/olibuijr/AkurAI-Framework" }
  ],
  "docs_nav": [
    {
      "title": "Guide",
      "items": [
        { "label": "Getting started", "href": "/docs/getting-started" },
        { "label": "Architecture", "href": "/docs/architecture" },
        { "label": "CLI & dev server", "href": "/docs/cli" },
        { "label": "Updating (self-update)", "href": "/docs/updating" }
      ]
    },
    {
      "title": "Building",
      "items": [
        { "label": "Routing", "href": "/docs/routing" },
        { "label": "Layouts", "href": "/docs/layouts" },
        { "label": "Data loaders", "href": "/docs/loaders" },
        { "label": "Forms & actions", "href": "/docs/forms" },
        { "label": "Storage", "href": "/docs/storage" },
        { "label": "SQL (parser)", "href": "/docs/sql" },
        { "label": "SQL executor", "href": "/docs/sql-executor" },
        { "label": "Auth & sessions", "href": "/docs/auth" },
        { "label": "Realtime (WS & SSE)", "href": "/docs/realtime" },
        { "label": "Reactivity", "href": "/docs/reactivity" },
        { "label": "Islands & hydration", "href": "/docs/islands" },
        { "label": "SPA router", "href": "/docs/spa-router" },
        { "label": "Middleware", "href": "/docs/middleware" },
        { "label": "SEO", "href": "/docs/seo" },
        { "label": "Styling (CSS engine)", "href": "/docs/styling" },
        { "label": "Asset pipeline", "href": "/docs/assets" }
      ]
    },
    {
      "title": "Design system",
      "items": [
        { "label": "Overview", "href": "/docs/design-system" },
        { "label": "Foundations", "href": "/docs/design-system/foundations" },
        { "label": "Components", "href": "/docs/design-system/components" }
      ]
    },
    {
      "title": "Reference",
      "items": [
        { "label": "API reference", "href": "/docs/api-reference" },
        { "label": "Roadmap & status", "href": "/docs/roadmap" },
        { "label": "Changelog", "href": "/changelog" }
      ]
    }
  ],
  "install": "$ akurai new myapp\n$ cd myapp\n$ akurai serve\n→ serving on http://localhost:8090",
  "code_sample": "# backend/collections.toml\n[[collection]]\nname = \"posts\"\n\n  [[collection.field]]\n  name  = \"title\"\n  type  = \"text\"\n  required = true\n\n  [[collection.field]]\n  name  = \"body\"\n  type  = \"text\"\n  embed = true        # indexed for semantic search\n\n# Generated automatically:\n#   GET/POST   /api/collections/posts/records\n#   GET        /api/collections/posts/records?search=rust",
  "features": [
    { "icon": "📦", "title": "Single static binary", "body": "Copy one file and run it. No runtime, no interpreter, no node_modules — about 660 KB." },
    { "icon": "🦀", "title": "Zero runtime dependencies", "body": "Pure std Rust. HTTP, JSON, the database, templates, and markdown are all written from scratch." },
    { "icon": "🗄️", "title": "Embedded database", "body": "A crash-safe, WAL-style relational store on a copy-on-write B+tree. No separate database server." },
    { "icon": "⚡", "title": "Auto-generated APIs", "body": "Declare collections; get REST endpoints, validation, and a self-describing manifest for free." },
    { "icon": "🧩", "title": "Server-side templates", "body": "A real SSR engine with a client-first, no-build frontend. Edit a file, reload, done." },
    { "icon": "🔍", "title": "Built-in semantic search", "body": "Embeddings on every collection, so similarity search works out of the box." }
  ],
  "stats": [
    { "value": "0", "label": "Runtime deps" },
    { "value": "1 file", "label": "To deploy" },
    { "value": "~713 KB", "label": "Binary size" },
    { "value": "no build", "label": "Frontend step" }
  ],
  "cards": [
    { "title": "Crash-safe by design", "body": "Atomic copy-on-write commits — durability comes from the storage engine, not luck." },
    { "title": "Self-describing", "body": "GET /api/_meta returns every route the schema generates." },
    { "title": "Edit-and-reload", "body": "Data lives in a runtime store and context files — never compiled into the binary." }
  ],
  "alerts": [
    { "kind": "success", "title": "Success.", "text": "This page is server-rendered by the framework itself." },
    { "kind": "info", "title": "Note.", "text": "TLS terminates at the edge; the server speaks plain HTTP." },
    { "kind": "warning", "title": "In progress.", "text": "Auto-generated REST APIs and semantic search over collections are the next milestone — not shipped yet." }
  ],
  "badges": [
    { "kind": "ok", "label": "build passing" },
    { "kind": "ok", "label": "clippy clean" },
    { "kind": "muted", "label": "v0.1.0" },
    { "kind": "muted", "label": "MIT" }
  ],
  "table": {
    "columns": ["Crate", "Role", "Status"],
    "rows": [
      ["akurai-http", "HTTP/1.1 server", "✅ done"],
      ["akurai-json", "JSON value + parser", "✅ done"],
      ["akurai-template", "SSR templates", "✅ done"],
      ["akurai-markdown", "Markdown → HTML", "✅ done"],
      ["akurai-storage", "Pager + crash-safe B+tree", "✅ done"],
      ["akurai-sql", "SQL lexer + parser", "✅ done"],
      ["akurai-sqlexec", "SQL executor over B+tree", "✅ done"],
      ["akurai-ws", "WebSocket + SSE", "✅ done"],
      ["akurai-router", "URL pattern matcher", "✅ done"],
      ["akurai-css", "Atomic CSS engine", "🧪 lib (not wired)"],
      ["akurai-assets", "Fingerprint + minify", "🧪 lib (not wired)"]
    ]
  }
}