Field guide

Atlas is two boilerplates: nineteen Bun packages for the web, and a Rust workspace for the desktop. Start with a working route, inspect the architecture when it matters, then open the exact reference beside your editor.

Walk the survey Quick start

Guides

Agent guide

Grounding order, package selection, MCP safety, context budgets, and verification.

Open guide
Architecture overview

The package graph, design philosophy, and the boundaries between modules.

Open guide
Quick start

Build an authenticated application with storage and an admin surface.

Open guide
API reference

A condensed, cross-package lookup for exports, types, and signatures.

Open guide
Cookbook

Practical recipes for common application patterns and edge cases.

Open guide
Project readme

Installation, package inventory, templates, and development commands.

Open guide

Desktop

Desktop architecture

The crate layering, the tokio bridge, state scopes, and the store.

Open guide
Desktop scaffolding

new.sh, the three templates, renaming an app, and developing Atlas alongside one.

Open guide
Desktop packaging

Every artifact an app ships on macOS, Linux, and Windows, and where it comes from.

Open guide
Desktop releases

Signing, notarization, cutting a release, and in-place self-update.

Open guide
Desktop gotchas

The gpui and guise traps, each with the symptom that led to it.

Open guide

Package manifest

Nineteen root exports. Each reference is generated from its canonical AGENTS.md.

@wess/atlas/configTyped environment variables and immutable configuration.foundation @wess/atlas/dbQuery building, schemas, changesets, and Postgres or SQLite drivers.foundation @wess/atlas/serverPipe-based HTTP, typed routes, WebSockets, and server-sent events.network @wess/atlas/authPasswords, JWTs, sessions, auth flows, and social sign-in.identity @wess/atlas/securityHeaders, rate limiting, audit logs, TOTP, and revocable sessions.identity @wess/atlas/oauthAn OAuth 2.1 server with PKCE, refresh rotation, and device flow.identity @wess/atlas/requestA fetch client with retries, interceptors, and provider presets.network @wess/atlas/storageS3-compatible object operations and presigned URLs.service @wess/atlas/cacheRedis caching, memory stores, TTLs, and cache-aside helpers.service @wess/atlas/cliCommands, scaffolding, documentation lookup, and Foreman.interface @wess/atlas/uiReact and Mantine blocks for forms, tables, auth, and more.interface @wess/atlas/adminSchema-driven CRUD routes and a generated administration UI.interface @wess/atlas/mcpApplication introspection and Atlas documentation over MCP.interface @wess/atlas/aiProviders, chat, embeddings, RAG, agents, and streaming.service @wess/atlas/edgeA TLS reverse proxy with built-in Let's Encrypt automation.network @wess/atlas/emailProvider-agnostic email delivery and account templates.service @wess/atlas/shareSocial share URLs and server-side share-by-email.service @wess/atlas/ssoAn OIDC relying party for signing in with an identity provider.identity @wess/atlas/migrateTimestamped SQL migrations and schema-diff generation.foundation
Type to search guides and package references.