Public roadmapUpdated for create-axonyx 0.2.16Pages/ASX V1 shippedNative Axonyx

Axonyx Roadmap

This page is the public compass for Axonyx: what already works, what is being sharpened now, what is next, and what belongs to later framework layers such as Blockbit CMS and deeper standard library modules.

Current focus

State + server loopHarden actions, state bridge, and production server behavior.

The first public loop is now real enough to publish and deploy. The next priority is making that loop dependable under real state, actions, production transport, and security pressure.

Framework maturity

Beta foundation80%
80%

Core authoring, build, deploy, data contracts, action metadata, and package publishing exist; state, server hardening, auth, and storage still need deeper passes.

Pages / ASX maturity

First complete authoring slice100%
100%

Function-shaped pages, `return ASX`, local components, props, state, render blocks, and route-scoped component JS are now a complete V1 slice.

UI maturity

Foundry component layer62%
62%

Foundry now has a broad native component catalog, but each page still needs richer previews and API detail.

Aegis QA maturity

Fast QA beta50%
50%

Aegis is usable today through `cargo ax test` for Cargo-first fast checks, status/text assertions, link assertions, and same-origin broken-link detection.

State bridge maturity

Patch + invalidation spine45%
45%

State manifests, action patches, invalidation events, typed local bindings, component-local signal IDs, compiler-owned local events, and reactive If boundaries exist; cross-file state graph work remains the next deeper state milestone.

WASM runtime maturity

Typed local executor V1 shipped45%
45%

WASM State V1 executes typed String, Number, and Bool local operations in Rust. The narrow browser host still owns events, UTF-8 transfer, and targeted DOM writes, with the existing JS executor retained as a fallback.

Milestone: Framework Beta Loop

Primary milestone

The next milestone is the first complete public loop: a developer can create an Axonyx app, write pages in .asx, use Foundry components, inspect routes/API/actions/schema contracts, build, deploy, and understand errors without dropping into framework internals.

Author

Clear .asx pages, layouts, components, params, optional values, and friendly parser errors.

Run

Reliable `cargo ax run dev`, route inspection, generated backend, static output, and deploy defaults.

Ship

Docs, UI previews, package versions, Render flow, and clear upgrade notes for beta users.

Now

Current work

Pages/ASX V1

Shipped

The first complete authoring slice is stable enough for real pages and reusable components.

  • Function-shaped `page Home()` with an explicit ASX return block
  • Local `component` blocks with props and defaults
  • Component-owned `state` for String, Bool, and Number values
  • Inline and external `client JS` emitted per route
  • `client WASM from "./file.wasm"` reserved for the next runtime layer

State bridge v1

In progress

Interactive State V1 now supports real local interactions without inline JavaScript or a virtual DOM.

  • Scoped and global state declarations
  • Action patch response and invalidation events
  • Query refresh model for mutated collections
  • Clear browser bridge contract owned by Axonyx

Production server v1

In progress

Harden the Tokio/Axum-backed path that powers `cargo ax run start` and hosted deploys.

  • Request limits and malformed request handling
  • Compression, security headers, and health checks
  • Clear Render/Docker start contracts
  • Better production error reporting and logs

Actions and validation

In progress

0.2.2 adds compiler-owned local events and reactive If boundaries to the Contract V1 and Pages/ASX foundation, while preserving typed server actions for trusted mutations.

  • `invalidate posts` stays a literal query key
  • `revalidate target` evaluates runtime bindings
  • Mutation invalidations are emitted automatically
  • `loadPosts(status)` is checked against the route-local query signature
  • `notFound()`, `noContent()`, and `redirect(...)` are visible in API contracts

Version alignment

Maintained

0.2.16 keeps create-axonyx and cargo-axonyx aligned with the published 0.2.1 runtime contract.

  • `create-axonyx 0.2.16`
  • `cargo-axonyx 0.2.16`
  • `axonyx-runtime 0.2.1`
  • `axonyx-core 0.2.1`

WASM client runtime bridge

V1 shipped

A 1,592-byte Rust/WASM executor now sits behind `ax-state/1` for typed local operations without becoming a dependency for static pages.

  • String, Number, and Bool `set/add/sub/toggle` executor shipped
  • ABI v2 validates supported type and operation pairs
  • Bounded 4 KiB scratch memory validates UTF-8 String payloads
  • `ax-state-event/1` validates browser event envelopes before execution
  • Executor diagnostics distinguish WASM, fallback, rejected, and deduped events
  • Browser host API boundary for DOM, events, storage, and network
  • Local-only widget interactions without a server round trip

Foundry UI parity

In progress

Grow `axonyx-ui` into a practical MUI-like foundation for Axonyx-native apps.

  • Layout primitives: Container, Grid, Stack, Surface, Toolbar
  • Controls: Button, Field, Select, Switch, Slider, MachineSwitch
  • Feedback/data: Alert, Toast, Table, List, Stat, StatusLamp
  • Native .asx component pages that match the React adapter story

Native site polish

In progress

Bring `axonyx.dev` pages to the same confidence level as the React adapter site.

  • Consistent docs/sidebar/pager navigation
  • Component pages with real preview, usage, and API links
  • Package versions and deploy commands kept current
  • Roadmap and documentation pages that explain the beta direction

Friendly framework errors

In progress

Make failed builds explain the fix instead of only exposing parser/runtime internals.

  • Missing component imports
  • Invalid props and optional value mistakes
  • Route render failures with file path and suggested fix

Aegis testing layer

Public beta

Build the Rust-first QA layer behind `cargo ax test`, while keeping it useful for React/Next sites today.

Cargo ax test ready, browser mode later50%
50%
  • `cargo install axonyx-aegis --force`
  • `cargo ax test` delegates to `aegis fast --config aegis.toml`
  • Status, text, link, and broken-link checks
  • Browser automation reserved for the next phase

Next

Near-term priorities

Query refresh after actions

In progress

Deepen action invalidations and typed query function calls so mutation flows keep page data fresh without hand-wired client state.

State bridge graph

Next

Let The Melt own a cross-file state graph, initial snapshots, and safe patch targets for actions and UI bindings.

Database production track

Next

Move from local SQLite proof toward Postgres, schema pull/check, migrations, typed table resources, and clearer query diagnostics.

WASM bridge plan

In progress

Extend the shipped WASM executor with validated event payloads and a narrower browser host API while keeping the compatibility fallback.

Production server config

Next

Move more deploy/runtime settings into `Axonyx.toml` so hosted, Docker, and local production starts share one model.

Security model

Next

Define secure-by-default rules for escaping, guarded routes, signed sessions, CSRF, capability-based file APIs, and `cargo ax doctor security`.

Docs guide expansion

Next

Add focused guides for state, actions, query invalidation, API routes, deploy, and package updates.

CLI polish

Next

Keep improving `cargo ax doctor`, `routes`, `api`, `actions`, `schema`, and deploy-friendly build behavior.

Actions and validation

Next

Document and harden form lifecycle, validation errors, redirects, and server-side mutation flow.

Component QA pass

Next

Every component page should have the same structure: intro, live preview, usage example, API reference link.

Later

Framework layers after the beta loop

Production server

Move deeper into Tokio/Hyper-style production transport, streaming, static assets, request limits, and deploy adapters.

Auth and sessions

Harden signed sessions, auth guards, crypto helpers, route protection, and error handling.

Data and storage

Design database adapters, file uploads, content collections, stream APIs, and schema/DTO discovery commands.

Blockbit CMS

Build the CMS as a higher layer on top of Axonyx primitives, not inside the core framework too early.

WASM client runtime

Grow the shipped local executor into the broader optional client runtime for typed patches and component behavior where WASM is worth loading.

Theme package system

Allow external design systems to ship as packages while the app keeps the same route/data/component structure.

Worker orchestration

Add background jobs and child process orchestration for image processing, content indexing, and heavier CMS tasks.

Done

Beta foundation already shipped

  1. PagesPages/ASX V1 component model

    Function-shaped pages, `return ASX`, local components, typed params, component-local state, render blocks, and route-scoped inline client JS.

  2. CoreJSX-like .asx pages

    Imports, fragments, paired tags, slots, page params/defaults, Head, If, Each, and native component packages.

  3. CLICargo-native developer loop

    `create-axonyx`, `cargo ax check`, `doctor`, `build`, `run dev`, `test`, `routes`, `api`, `actions`, and `schema pull`.

  4. RuntimeServer-rendered routes and state bridge seed

    Static route rendering, nested layouts, loaders, content collections, action forms, and local state binding metadata.

  5. ActionsAction invalidation semantics

    `invalidate` literal keys, `revalidate` expression targets, automatic mutation invalidation, patch response invalidations, refresh metadata, page fragment refreshes, redirect fallback safety, and integration guard tests shipped through the current 0.1.x line.

  6. DataTyped query function inputs

    `query loadPosts(status: String)` can now bind page data calls such as `loadPosts(status)`, and `cargo ax check` reports missing or extra query arguments before runtime.

  7. ReleaseCargo packages aligned

    `create-axonyx 0.2.16`, `cargo-axonyx 0.2.16`, `axonyx-runtime 0.2.1`, and `axonyx-core 0.2.1` are published.

  8. UIFoundry UI package

    `axonyx-ui` ships as Cargo and npm package with CSS, JS helpers, and native `.asx` Foundry components.

  9. DeployNative Axonyx site online

    The public site is authored in Axonyx and deployed from the native framework loop.

How to read this roadmap

Axonyx is still beta. Items may move as the framework gets tested on real pages, real deploys, and future CMS flows. The rule is simple: stabilize the smallest useful full-stack loop first, then widen the standard library and CMS story without breaking the core authoring model.