LetterSpace

Open Source Self-Hosted Newsletter Platform

LetterSpace is an open source newsletter application that gives you complete control over your subscriber lists and email campaigns.

Features

• Full Ownership: Self-host your newsletter infrastructure
• Subscriber Management: Organize and segment your audience
• Email Campaigns: Create and send beautiful emails
• Analytics: Track open rates, clicks, and subscriber growth
• Custom Domains: Use your own domain for professional branding
• API Access: Integrate with your existing tools and workflows

Tech Stack

• NextJS
• TypeScript
• TailwindCSS
• Shadcn UI
• PostgreSQL
• TRPC
• Prisma

Environment Variables

Required Variables

• JWT_SECRET - Secret key for JWT token signing
• DATABASE_URL - PostgreSQL database connection string

Optional Variables

• WEBHOOK_MEMORY_LIMIT - Memory limit for webhook transformer runtime in bytes (default: 16777216 = 16MB)
• WEBHOOK_MAX_STACK_SIZE - Maximum stack size for webhook transformer in bytes (default: 262144 = 256KB)

Testing

The backend suite runs against a real PostgreSQL database configured by apps/backend/.env.test:

createdb letterspace_test
pnpm test

See docs/testing.md for the database setup, the test factories, and the CI workflow.

Documentation

Feature docs live in docs/ - one file per feature.

Getting Started

Deployment

Detailed deployment instructions are available in the getting started guide.

Contributing

We welcome contributions! Please see our contributing guidelines for more details.

License

MIT

Support

• Documentation
• GitHub Issues

---

Visit letterspace.dcodes.dev for more information.