Documentation Index
Fetch the complete documentation index at: https://docs.getmaito.com/llms.txt
Use this file to discover all available pages before exploring further.
Environment Variables
Environment variables are app and package specific. Keep real secrets in local.env or .env.local files and never commit them.
Common Variables
| Name | Purpose |
|---|---|
DATABASE_URL | PostgreSQL connection string for API, workers, jobs, and database tools. |
API_URL | Server-side API base URL for app/frontends. |
VITE_API_URL | Browser-visible API base URL. |
SERVER_URL | Public web server URL. |
PORT | HTTP port for Bun/Hono services. |
OPENAI_API_KEY | AI model access for generation features and public tools. |
CLERK_SECRET_KEY | Clerk server-side authentication secret. |
VITE_CLERK_PUBLISHABLE_KEY | Clerk browser publishable key. |
NEWSLETTER_INTERNAL_API_TOKEN | Internal token for newsletter public surfaces calling the API. |
NEWSLETTER_ROOT_DOMAIN | Root domain used for hosted newsletter sites. |
NEWSLETTER_CLICK_TOKEN_SECRET | Secret for newsletter click tracking tokens. |
NEWSLETTER_UNSUBSCRIBE_TOKEN_SECRET | Secret for unsubscribe tokens. |
NEWSLETTER_REFERRAL_HASH_SECRET | Secret for newsletter referral hashing. |
SOCIAL_CREDENTIALS_KEY_B64 | Encryption key for stored social credentials. |
SOCIAL_CREDENTIALS_KEY_ID | Active social credential key identifier. |
SOCIAL_X_API_KEY | X/Twitter API key. |
SOCIAL_X_API_SECRET | X/Twitter API secret. |
S3_URL | S3/R2-compatible endpoint. |
S3_REGION | S3/R2 region. |
S3_ACCESS_KEY | S3/R2 access key. |
S3_SECRET_KEY | S3/R2 secret key. |
STRIPE_SECRET_KEY | Stripe server-side secret key. |
STRIPE_WEBHOOK_SECRET | Stripe webhook signing secret. |
MCP_ACCESS_TOKEN | Token used by MCP smoke tests. |
Browser Variables
Only expose values to the browser when they are designed to be public. Browser variables should use the framework-required public prefix, such asVITE_.
Adding A Variable
When adding a required variable:- Add runtime validation where the app already validates env.
- Update the relevant
.env.examplefile if one exists. - Document the variable here or in a more specific operations doc.
- Avoid adding production defaults for secrets.