evjs

React meta-framework, built on TanStack + Hono.

ev = Evaluation · Evolution — evaluate across runtimes, evolve with AI tooling.

⚡ Features

• Convention over Configuration — ev dev / ev build, no boilerplate needed.
• Type-Safe Routing — TanStack Router.
• Data Fetching — TanStack Query with built-in proxies.
• Server Functions — "use server" directive, auto-discovered at build time.
• Pluggable Transport — HTTP, WebSocket, or custom via ServerTransport.
• Plugin System — extend builds with custom loaders (Tailwind, SVG, etc.).
• Programmatic Route Handlers — Standard Request/Response REST API endpoints via route().
• Typed Errors — ServerError flows structured data server → client.
• Multi-Runtime — Hono-based server with Node, Deno, Bun, Edge adapters.
• CLI — ev dev · ev build

🚀 Quick Start

npx @evjs/create-app my-app
cd my-app && npm install
ev dev

After ev dev, your browser opens to http://localhost:3000 with hot module replacement. Server functions in *.server.ts files are auto-discovered — no config needed.

🏗️ Packages

Package	Purpose
@evjs/cli	CLI + defineConfig
@evjs/create-app	Project scaffolding (npx @evjs/create-app)
@evjs/shared	Shared errors, constants
@evjs/client	Client runtime (React + TanStack)
@evjs/server	Server runtime (Hono)
@evjs/build-tools	Server function transforms
@evjs/webpack-plugin	Webpack adapter
@evjs/manifest	Shared manifest schema types
examples/	Starter templates

See ARCHITECTURE.md · AGENT.md

🛠️ Development

npm install          # deps
npm run build        # all packages + examples
npm run test         # vitest
npm run test:e2e     # playwright

📄 License

MIT © xusd320