React fullstack framework, built on TanStack + Hono.
ev = Evaluation · Evolution — evaluate across runtimes, evolve with AI tooling.
- 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
createRoute(). - Typed Errors —
ServerErrorflows structured data server → client. - Multi-Runtime — Hono-based server with Node, Deno, Bun, Edge adapters.
- CLI —
ev dev·ev build
npx @evjs/create-app my-app
cd my-app && npm install
ev devAfter 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.
| Package | Purpose |
|---|---|
@evjs/cli |
CLI binary (ev dev, ev build) |
@evjs/ev |
Config, plugin, and bundler types (defineConfig) |
@evjs/create-app |
Project scaffolding (npx @evjs/create-app) |
@evjs/shared |
Runtime shared: errors, HTTP utils, constants |
@evjs/client |
Client runtime (React + TanStack) |
@evjs/server |
Server runtime (Hono) |
@evjs/build-tools |
Server function transforms |
@evjs/bundler-webpack |
Webpack adapter |
@evjs/manifest |
Shared manifest schema types |
examples/ |
Starter templates |
See ARCHITECTURE.md · AGENT.md
npm install # deps
npm run build # all packages + examples
npm run test # vitest
npm run test:e2e # playwrightMIT © Ant UED