Build once, deploy anywhere. A universal, cloud-native micro-kernel framework — one codebase for backend and frontend, running on Node, serverless (FaaS), the browser, the CLI and the edge.
Stone.js is the reference implementation of the Continuum Architecture: an application is not an object but an act — Application = Domain × Context → Resolution. You write your domain once; Stone.js is the context that applies to it at runtime.
This repository is the monorepo for the whole framework: every @stone-js/* package lives here and is released together (lockstep).
| Dimension | Incarnation | Role |
|---|---|---|
| Setup | Blueprint (@stone-js/config + core BlueprintBuilder) |
A single configuration manifest, built once before any event, by decorator introspection or imperative meta-modules. |
| Integration | Adapters (one package per platform) | Capture raw causes, normalise them into intentions (IncomingEvent), turn responses back into native effects. |
| Initialization | Kernel (@stone-js/core) |
Applies the container (per-event execution context) + the domain to the intention; middleware, hooks, error handlers. |
| Functional | Your code | Handlers and services — no imposed structure. |
| Package | Description |
|---|---|
@stone-js/pipeline |
Chain-of-responsibility pipeline (middleware engine). |
@stone-js/service-container |
Dependency-injection container. |
@stone-js/config |
Blueprint store + zero-dep utils (cloneValue, deepMerge, getPath). |
| Package | Description |
|---|---|
@stone-js/core |
The platform-agnostic micro-kernel. |
| Package | Description |
|---|---|
@stone-js/http-core |
Runtime-agnostic HTTP primitives. |
@stone-js/router |
Universal router (Node + browser), serverless-oriented. |
@stone-js/env |
Environment variable access. |
@stone-js/filesystem |
Filesystem abstraction (S3-ready). |
@stone-js/browser-core |
Browser HTTP/event primitives. |
| Package | Description |
|---|---|
@stone-js/node-http-adapter |
Node.js HTTP server. |
@stone-js/node-cli-adapter |
Node.js CLI. |
@stone-js/aws-lambda-adapter |
Generic AWS Lambda (any trigger). |
@stone-js/aws-lambda-http-adapter |
AWS Lambda HTTP triggers. |
@stone-js/browser-adapter |
Browser SPA. |
| Package | Description |
|---|---|
@stone-js/use-view |
Framework-agnostic view layer. |
@stone-js/use-react |
React integration (SSR/CSR). |
| Package | Description |
|---|---|
@stone-js/cli |
Build & scaffolding CLI for every project type. |
@stone-js/starters |
Official project templates. |
@stone-js/docs |
Documentation site. |
# Scaffold a new app
npm create @stone-js@latest my-app
cd my-app && npm install && npm run devSee stonejs.dev for full documentation.
New here? Read MONOREPO.md — a step-by-step guide to how the monorepo works, what each tool does, and every command you need to pilot it yourself.
pnpm install # install everything, link internal packages
pnpm build # build all packages (turbo, cached)
pnpm test # run all tests
pnpm lint # lint all packages
pnpm changeset # record a change for the next releaseContributing? See CONTRIBUTING.md. Security issues? See SECURITY.md.
MIT © Evens Pierre ("Mr. Stone") and the Stone.js contributors.