quickslice

Quickslice is a quick way to spin up an AppView for AT Protocol applications. Import your Lexicon schemas and you get a GraphQL API with OAuth authentication, real-time sync from the network, and joins across record types without setting up a database or writing any backend code.

Warning
This project is in early development. APIs may change without notice.

What Quickslice Does

• Connects to Jetstream and tracks the record types defined in your Lexicons
• Indexes relevant records into a database (SQLite or Postgres)
• Generates GraphQL queries, mutations, and subscriptions from your Lexicon definitions
• Handles OAuth and writes records back to the user’s PDS
• Enables joins by DID, URI, or strong reference, so you can query a status and its author’s profile in one request

Example

The status lexicon (xyz.statusphere.status):

{
  "lexicon": 1,
  "id": "xyz.statusphere.status",
  "defs": {
    "main": {
      "type": "record",
      "key": "tid",
      "record": {
        "type": "object",
        "required": ["status", "createdAt"],
        "properties": {
          "status": {
            "type": "string",
            "minLength": 1,
            "maxGraphemes": 1,
            "maxLength": 32
          },
          "createdAt": { "type": "string", "format": "datetime" }
        }
      }
    }
  }
}

Querying the status records:

query {
  xyzStatusphereStatus(
    first: 50
    sortBy: [
      { field: createdAt, direction: DESC }
    ]
    where: {
      status: { contains: "👍" }
    }
  ) {
    edges {
      node {
        uri
        did
        status
        createdAt
      }
      cursor
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

Quick Start

Docker

Run Quickslice locally with Docker:

docker compose up --build

Open http://localhost:8080 and login with your Bluesky handle.

For PostgreSQL instead of SQLite:

docker compose -f docker-compose.postgres.yml up --build

Native Development

For development without Docker:

Prerequisites:

• Gleam v1.13+
• dbmate for migrations
• Node.js 18+ (for client build)

Setup:

# Server
cd server
cp .env.example .env
make db-setup-sqlite
gleam run

# Client (rebuild after changes)
cd client
npm install
gleam run -m lustre/dev build

See server/README.md for detailed configuration.

Documentation

• Queries
• Joins
• Mutations
• Subscriptions
• Blobs
• Variables
• Deployment

Structure

• server/ - Main server with database layer, GraphQL API, and Jetstream ingestion
• lexicon_graphql/ - GraphQL schema generation from AT Protocol Lexicons
• atproto_car/ - CAR (Content Addressable aRchive) file parsing for backfills
• client/ - Web-based GraphQL playground and admin UI
• quickslice-client-js/ - JavaScript client library
• www/ - Documentation website

License

Apache License 2.0