Slice Kit#

A starter kit for building apps on the Atmosphere with Quickslice.

Prerequisites#

docker compose up

Login at http://127.0.0.1:8080 to create an admin account
Go to the settings page. Enter your domain authority (e.g., com.example) - this is the namespace for your app's lexicons. Leave blank if unsure; app.bsky.actor.profile will be treated as an external collection.
Upload lexicons.zip in the Lexicons section
Register an OAuth client at http://127.0.0.1:8080/oauth/clients
- Name: frontend client
- Type: public
- Redirect URIs: http://localhost:3000/
- Scope: atproto transition:generic
Copy the client ID and set it in index.html:

const CLIENT_ID = "your_client_id_here";

make serve

Open http://localhost:3000 and login with your Bluesky handle. You should see your Bluesky avatar and profile info after logging in, it's synced automatically after logging in.
Configure the Quickslice MCP server for your AI assistant. Example:

claude mcp add --scope user quickslice http://127.0.0.1:8080/mcp

Add your own custom lexicons to the /lexicons folder, run make zip, and upload on the settings page. Ask the Quickslice MCP about your lexicons and use it to help build your app.

Environment variables in docker-compose.yml:

Variable	Description
`DATABASE_URL`	SQLite database path
`SECRET_KEY_BASE`	Session signing key (generate your own for production)
`OAUTH_SIGNING_KEY`	OAuth token signing key (generate your own for production)
`OAUTH_LOOPBACK_MODE`	Enables localhost OAuth redirects for development
`EXTERNAL_BASE_URL`	Public URL of your server

Command	Description
`make serve`	Serve frontend locally
`make format`	Format HTML files with Prettier
`make zip`	Create `lexicons.zip` from lexicons directory

Backend: See the deployment guide for deploying your Quickslice instance.

Frontend: Deploy to a CDN or wisp.place.