advanxjs
v0.1.13
Published
The first Agent-Native (AX) frontend framework.
Readme
AdvanxJS: The Agent-Native Framework
Stop fighting AI hallucinations. Start building with Agent Experience (AX).
AdvanxJS is a next-generation frontend framework designed to be perfectly readable, writable, and maintainable by AI Agents (Claude, Gemini, GPT-4). While traditional frameworks like React and Next.js are built for humans (DX), AdvanxJS is built for the AI + Human partnership.
Quick Start
Scaffold a new AdvanxJS project in one command — no clone, no install required:
npx advanxjs@latest create my-app
cd my-app
bun install
advanxjs build src/components/counterThat's it. You get a fully-structured project with a sample counter component, the runtime, the directives engine, and a CONSTITUTION.md that AI agents can read to understand the project rules.
Why AdvanxJS?
Modern frontend code is a mess of mixed logic and UI (JSX), which causes AI agents to hallucinate, mismanage hooks, and create "glue-code" bugs. AdvanxJS solves this with a strict Split-Brain Architecture.
- Performance: No Virtual DOM. Surgical O(1) DOM updates via Signals.
- AI-Native (AX): Logic, View, and Style are strictly separated so AI never loses context.
- Bun-Native: Built to leverage the speed of the Bun runtime and bundler.
- SEO-First: Pure HTML/CSS output. No hydration "jank." 100/100 Lighthouse scores by default.
CLI Commands
| Command | Description |
|---|---|
| advanxjs create <name> | Scaffold a new AdvanxJS project with the sample counter |
| advanxjs build <component-path> | Compile a component (logic.ts + view.html + style.css) |
| advanxjs explain <component-path> | Print the component's contract from .advanx-meta.json |
| advanxjs --help | Show help |
The Advanx Constitution
AdvanxJS is governed by 7 Immutable Articles:
- The Trinity of Separation: Component =
logic.ts+view.html+style.css. - The Signal is Truth: Reactivity is handled exclusively via Signals.
- Static by Default: Minimal JS. Ship only what is interactive.
- AI-Context Guarantee: Modular files designed to fit within AI context windows.
- No Magic, Only Contracts: Build-time validation of logic-to-view bindings.
- Performance as a Constraint: Tiny runtime (<5KB gzipped).
- Intent Over Behavior: Declarative HTML attributes over imperative JS.
Requirements
- Bun — the CLI uses Bun as its runtime. The launcher will print an install hint if Bun is missing.
- Node.js 18+ (for
npxitself; the launcher shim runs on Node).
Roadmap
- [x] Phase 1: The Spark — Core Runtime + Contract Validator
- [x] Phase 2: The Engine —
ax-if,ax-forDirectives & List Rendering - [x] Phase 3: The CLI — Project Scaffolding &
npx advanxjs create - [ ] Phase 4: AdvanxUI — Agent-Native Premium Component Library
Founder
Rahul Dodwe Building the future of Agent-Native (AX) development. Follow the journey on GitHub
License
MIT © 2026 Rahul Dodwe
