AkurAI-Framework / site/backend/page.json

Latest change 01843dea338a2aaeff9b2715a27a3f46d50bc083 - feat(site): interactive /realtime demo page (live WS echo + SSE counter) by Ólafur Búi Ólafsson

{
  "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.0.1",
  "year": 2026,
  "nav": [
    { "label": "Docs", "href": "/docs" },
    { "label": "Components", "href": "/components" },
    { "label": "Realtime", "href": "/realtime" },
    { "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", "href": "/docs/cli" },
        { "label": "Realtime (WS & SSE)", "href": "/docs/realtime" }
      ]
    },
    {
      "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": "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": "~660 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": "The SQL layer over the storage engine is still being built." }
  ],
  "badges": [
    { "kind": "ok", "label": "build passing" },
    { "kind": "ok", "label": "clippy clean" },
    { "kind": "muted", "label": "v0.0.1" },
    { "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 + B+tree", "⏳ building"]
    ]
  }
}