The modern email automation platform for managing and streamlining your email operations.
IN PROGRESS
COMING SOON
IN PROGRESSWe're actively working on comprehensive development documentation. In the meantime, check the docs folder for setup guides and feature details. If you have any questions, feel free to open an issue or join our community!
ColdJot is a powerful email automation platform designed to help businesses manage and streamline their email operations. With a focus on productivity and efficiency, ColdJot provides advanced email management capabilities, real-time processing, and a modern web interface.
- Email Sequences — Multi-step sequence automation with flexible timing, scheduling, and conditional logic for personalized follow-ups.
- Analytics Dashboard — Open and click tracking, response rate monitoring, and sequence performance metrics.
- Contact Management — Import, organize, and segment contacts with activity history tracking.
- Email Templates — Reusable rich-text templates with centralized editing that propagates everywhere.
- Multiple Mailbox Support — Connect unlimited accounts with centralized management and per-mailbox quotas.
- Gmail Integration — OAuth-based Gmail connectivity with reply tracking, quota management, and automatic rate limiting.
- Timeline View — Visualize your sequence timeline and monitor outgoing communications in real-time.
- Security & Privacy — Google OAuth authentication, privacy-focused design, and data protection measures.
📋 See the full feature breakdown for status badges and upcoming features.
ColdJot is built with modern and reliable technologies:
- Next.js – framework
- TypeScript – language
- Tailwind – CSS
- PostgreSQL – database
- Redis – caching & queues
- BullMQ – job processing
- Auth.js – authentication
- Turborepo – monorepo
- Prisma – ORM
# 1. Install dependencies
npm install
# 2. Start local services (PostgreSQL + Redis)
docker compose up -d
# 3. Copy env files and configure them
cp apps/web/env/.env.example apps/web/env/.env.development
cp apps/mailops/env/.env.example apps/mailops/env/.env.development
cp packages/database/env/.env.example packages/database/env/.env.development
# 4. Set up the database
cd packages/database && npm run db:generate && npm run db:migrate && cd ../..
# 5. Run the development server
npm run devThen open http://localhost:3000.
➡️ For the full setup guide (prerequisites, Google OAuth, env vars, optional Gmail reply notifications), see Getting Started.
| Guide | Description |
|---|---|
| Getting Started | Prerequisites, Docker, Google OAuth, env vars, database setup |
| Features | Full feature breakdown and development status |
| Database | Database commands across environments |
| Environment Variables | How env files load across the monorepo |
| Gmail Reply Notifications | Optional PubSub setup for real-time replies |
We love our contributors! Here's how you can contribute:
- Open an issue if you believe you've encountered a bug.
- Make a pull request to add new features/make quality-of-life improvements/fix bugs.
If you spot a problem with the docs, search if an issue already exists. If a related issue doesn't exist, you can open a new issue using a relevant issue form. To solve an existing issue, scan through our issues and open a PR with a fix.
When you're finished with your changes, create a pull request:
- Fill the "Ready for review" template so reviewers understand your changes.
- Link the PR to any issue it resolves.
- We may ask for changes before merging — apply suggested changes and mark conversations as resolved.
ColdJot is open-source under the GNU Affero General Public License Version 3 (AGPLv3) or any later version. You can find it here.
🤍 ColdJot – Email Automation, Reimagined.