Wisp is in pre-release, self-hosted since GitHub suspended us. Install it, or see the changelog.

Wisp

Why Wisp

Short Code

A folder is a URL, and its +page.wisp is the page: Rust that loads data and handles forms, then markup. A model, a saved table, a validated action, a form and a list fit in about twenty lines. A prelude covers imports. See Getting started.

Fast

A route pays only for the features it uses. Every change to the request path is checked with an instructions-per-request comparison. See Benchmarks.

Few Tokens

An AI pays for every token it reads and writes. The same five features take 477 tokens in Wisp, 1,134 in SvelteKit and 1,146 in Next.js. A larger app with sign up, uploads and live refresh takes 1,014, against 3,668 and 3,458. See Tokens.

What Is Included

  • Forms: #[action], #[validate] and <form fields>. See Forms.
  • Data: #[model] tables saved to log files or a database. See Data.
  • Sign in: cx.login, cx.user, sessions, roles, signed tokens, two-factor codes and OAuth. See Auth.
  • APIs: #[derive(Rest)] writes a CRUD resource, an OpenAPI document and a TypeScript client. See APIs.
  • Live pages: streaming, {#await} and WebSockets. See Streaming and Embedding.
  • Sites: Markdown pages, translations, a sitemap and robots.txt. See Tooling.
  • Browser: a client router, an offline form queue (data-wisp-queue), PWA support, $state in a plain <script>, and islands for React, Vue, Svelte or Preact. Components ship no JavaScript by default. See Browser code.
  • No JavaScript: forms, search, paging, tabs and menus work with scripts off. See Without JavaScript.

Dev Loop

wisp dev swaps markup edits in and keeps $state. wisp check verifies routes and templates without compiling. wisp fmt formats .wisp files. wisp test runs your tests, in a browser with --browser. wisp lsp gives diagnostics and hover docs in your editor (Editors). wisp new, wisp route add and wisp recipe add scaffold (Tooling). See the CLI.

Ship Anywhere

The app, styles and static files are one binary (Deploying). Other targets are wisp build --static, wisp deploy init docker and wisp build --target cloudflare|deno|vercel|netlify|node|bun|lambda (Hosts). With the tower feature, Wisp runs inside axum, hyper or Lambda (Embedding). JSON logs, Prometheus metrics and OpenTelemetry traces are in Observe. An app can serve as a Tor onion service.

For AI Agents

AGENTS.md and llms-full.txt cover the whole framework, and wisp mcp serves the docs to coding agents (Editors and agents). Template mistakes are build errors.

Durable

Every fast path is tested at startup, with a safe fallback. A handler panic becomes a 500. The parsers are fuzzed, and request smuggling shapes are refused. Every file is audited within three days of a change, but no third party has audited Wisp. See Security.

Bigger apps use hooks, named middleware, layout options, slots and intercepting routes (Parity features).

Is This Page Useful?

View This Page's Source

Type to search every docs page and heading.