luminaweb alpha Get started
docs

Luminaweb Docs alpha

Luminaweb is an agent-native CLI and runtime for building small full-stack TypeScript apps called capsules. The capsule directory is the whole app: server contract, Preact client, runtime state, deploy URL.

Start here

Create and run a capsule:

npx luminaweb new my-app --template todo
cd my-app
npx luminaweb dev

npx luminaweb create is an alias for npx luminaweb new. New capsules get a git repository and initial commit unless created inside an existing git repository or --no-git is passed.

Capsule shape

server/index.ts        # schema, queries, mutations, endpoints
client/index.tsx       # Preact UI
shared/                # pure types & helpers
.env.luminaweb.server  # server-only env

Read next

  • Quickstart — the fastest path from npm i to a live URL.
  • Capsule API — the API shape an agent uses.
  • Reference — capsule runtime, data API, CLI, deploy.
  • CLI — every command, every flag.
  • Deploy — pushing to the Luminaweb Edge.