Configuration

Secrets

Secrets are set with wrangler secret put <name> and are not stored in your source code.

Secret	Required	Description
`BETTER_AUTH_SECRET`	Yes	Random string used to sign auth tokens. Use at least 32 characters.
`GITHUB_CLIENT_ID`	No	GitHub OAuth app client ID
`GITHUB_CLIENT_SECRET`	No	GitHub OAuth app client secret
`GOOGLE_CLIENT_ID`	No	Google OAuth app client ID
`GOOGLE_CLIENT_SECRET`	No	Google OAuth app client secret

Set these in your wrangler.jsonc under [vars]:

Variable	Description
`BASE_URL`	The public URL of your Jeremy instance (e.g. `https://jeremy-app.ian-muench.workers.dev`)

Configure these in your wrangler.jsonc:

{
  "d1_databases": [
    {
      "binding": "DB",
      "database_name": "jeremy-db",
      "database_id": "<your-database-id>"
    }
  ]
}

Stores library metadata, documentation chunks, user accounts, sessions, and API keys.

{
  "r2_buckets": [
    {
      "binding": "DOCS_BUCKET",
      "bucket_name": "jeremy-docs"
    }
  ]
}

Stores raw chunk data as backups.

{
  "vectorize": [
    {
      "binding": "VECTORIZE",
      "index_name": "docs-index"
    }
  ]
}

Stores 768-dimension vector embeddings for semantic search.

{
  "ai": {
    "binding": "AI"
  }
}

Used to generate embeddings with the @cf/baai/bge-base-en-v1.5 model.

{
  "browser": {
    "binding": "BROWSER"
  }
}

Provides headless Chromium for crawling JavaScript-rendered documentation pages.

Jeremy requires the nodejs_compat compatibility flag:

{
  "compatibility_flags": ["nodejs_compat"]
}