Scrawn Backend

The backend service for Scrawn - a usage-based billing platform with gRPC API endpoints for event tracking, authentication, and payment processing.

Overview

Scrawn backend provides gRPC services for:

• Event tracking - Register SDK calls and usage events
• Authentication - API key management
• Payment processing - Checkout link generation via Lemon Squeezy

Works with the Scrawn frontend SDK. For detailed API documentation and gRPC endpoint usage, visit the Scrawn Docs.

Railway Quickstart

Prerequisites

• Bun (latest version)
• PostgreSQL database
• Lemon Squeezy account (for payment processing)

Setup

1. Install dependencies

   bun install

2. Configure environment variables

   Create a .env.local file in the backend directory:

   DATABASE_URL=postgresql://user:password@localhost:5432/scrawn
   HMAC_SECRET=your-hmac-secret-key
   LEMON_SQUEEZY_API_KEY=your-ls-api-key
   LEMON_SQUEEZY_STORE_ID=your-store-id
   LEMON_SQUEEZY_VARIANT_ID=your-variant-id
   LEMON_SQUEEZY_WEBHOOK_SECRET=your-webhook-secret

3. Run database migrations

   bunx drizzle-kit push

4. Generate initial API key (optional)

   bun run init_key

5. Generate protocol buffers (if needed)

   bun run gen

Running the Server

Development mode (with auto-reload):

bun run dev:backend

Production mode:

bun start

The server will start on http://localhost:8069

Endpoints

• gRPC services: http://localhost:8069 (all gRPC endpoints)
• Webhook: http://localhost:8069/webhooks/lemonsqueezy/createdCheckout

Documentation

For complete gRPC API documentation, endpoint details, and integration guides, check API references..