AkurAI-Framework / site/backend/page.json

Latest change 881812b3d99e8d00c1568ee4311a3c822a652763 - release: v0.6.0 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.6.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": "Admin",
      "href": "/admin"
    },
    {
      "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": "Collections & auto-API",
          "href": "/docs/auto-api"
        },
        {
          "label": "Semantic search",
          "href": "/docs/semantic-search"
        },
        {
          "label": "Collections config (TOML)",
          "href": "/docs/toml"
        },
        {
          "label": "File uploads",
          "href": "/docs/uploads"
        },
        {
          "label": "Typed client SDK",
          "href": "/docs/client-sdk"
        },
        {
          "label": "Admin UI",
          "href": "/docs/admin"
        },
        {
          "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"
        },
        {
          "label": "Static generation (SSG/ISR)",
          "href": "/docs/ssg"
        },
        {
          "label": "Internationalisation",
          "href": "/docs/i18n"
        },
        {
          "label": "Error & loading boundaries",
          "href": "/docs/boundaries"
        }
      ]
    },
    {
      "title": "AI components",
      "items": [
        {
          "label": "Overview",
          "href": "/docs/ai-components"
        }
      ]
    },
    {
      "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": "Breaking changes",
          "href": "/docs/breaking-changes"
        },
        {
          "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": "binary",
      "title": "Single static binary",
      "body": "Copy one file and run it. No runtime, no interpreter, no node_modules — about 1.1 MB."
    },
    {
      "icon": "rust",
      "title": "Zero runtime dependencies",
      "body": "Pure std Rust. HTTP, JSON, the database, templates, and markdown are all written from scratch."
    },
    {
      "icon": "database",
      "title": "Embedded database",
      "body": "A crash-safe relational store on a copy-on-write B+tree with atomic, WAL-free commits. No separate database server."
    },
    {
      "icon": "api",
      "title": "Auto-generated APIs",
      "body": "Declare collections; get REST endpoints, validation, and a self-describing manifest for free."
    },
    {
      "icon": "templates",
      "title": "Server-side templates",
      "body": "A real SSR engine with a client-first, no-build frontend. Edit a file, reload, done."
    },
    {
      "icon": "search",
      "title": "Built-in semantic search",
      "body": "Mark a field to embed; `?search=` ranks records by similarity against any OpenAI-compatible endpoint, with substring search as the fallback."
    }
  ],
  "stats": [
    {
      "value": "0",
      "label": "Runtime deps"
    },
    {
      "value": "1 file",
      "label": "To deploy"
    },
    {
      "value": "~1.1 MB",
      "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": "info",
      "title": "New in v0.5.0.",
      "text": "Static generation with incremental revalidation (SSG/ISR), internationalisation with a {{ t }} template helper and Accept-Language negotiation, and declarative error/loading boundaries for client navigation."
    }
  ],
  "badges": [
    {
      "kind": "ok",
      "label": "build passing"
    },
    {
      "kind": "ok",
      "label": "clippy clean"
    },
    {
      "kind": "muted",
      "label": "v0.6.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",
        "✅ done"
      ],
      [
        "akurai-assets",
        "Fingerprint + minify",
        "✅ done"
      ],
      [
        "akurai-toml",
        "TOML config parser",
        "✅ done"
      ],
      [
        "akurai-collections",
        "Auto-API records",
        "✅ done"
      ],
      [
        "akurai-vector",
        "Embeddings + search",
        "✅ done"
      ]
    ]
  }
}