{"id":25684296,"url":"https://github.com/Mail-0/Mail-0","last_synced_at":"2025-02-24T17:04:17.554Z","repository":{"id":275505863,"uuid":"926252103","full_name":"Mail-0/Mail-0","owner":"Mail-0","description":"open source gmail alternative (coming soon). join the discord: https://discord.gg/adkjqMUK","archived":false,"fork":false,"pushed_at":"2025-02-20T01:22:48.000Z","size":3897,"stargazers_count":2638,"open_issues_count":28,"forks_count":219,"subscribers_count":22,"default_branch":"main","last_synced_at":"2025-02-20T01:37:26.329Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://mail0.io","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Mail-0.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-02T22:25:26.000Z","updated_at":"2025-02-20T01:22:51.000Z","dependencies_parsed_at":"2025-02-20T01:37:38.128Z","dependency_job_id":"56c43be2-9f06-48de-b5ea-6a7dadc390c7","html_url":"https://github.com/Mail-0/Mail-0","commit_stats":null,"previous_names":["nizzyabi/mail","nizzyabi/mail0","mail-0/mail-0"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mail-0%2FMail-0","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mail-0%2FMail-0/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mail-0%2FMail-0/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mail-0%2FMail-0/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mail-0","download_url":"https://codeload.github.com/Mail-0/Mail-0/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240521012,"owners_count":19814693,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-24T17:02:00.754Z","updated_at":"2025-02-24T17:04:17.549Z","avatar_url":"https://github.com/Mail-0.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# Mail0.io\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fnizzyabi%2FMail0\u0026env=DATABASE_URL,BETTER_AUTH_SECRET,BETTER_AUTH_URL,BETTER_AUTH_TRUSTED_ORIGINS,GOOGLE_CLIENT_ID,GOOGLE_CLIENT_SECRET,GOOGLE_REDIRECT_URI,GITHUB_CLIENT_ID,GITHUB_CLIENT_SECRET,GITHUB_REDIRECT_URI\u0026envDescription=For%20more%20info%20on%20setting%20up%20your%20API%20keys%2C%20checkout%20the%20Readme%20below\u0026envLink=https%3A%2F%2Fgithub.com%2Fnizzyabi%2FMail0%2Fblob%2Fmain%2FREADME.md\u0026project-name=0\u0026repository-name=0\u0026redirect-url=0.email\u0026demo-title=0\u0026demo-description=An%20open%20source%20email%20app\u0026demo-url=0.email) \u003c!-- omit from toc --\u003e\n\nAn Open-Source Gmail Alternative for the Future of Email\n\n## Table of Content \u003c!-- omit from toc --\u003e\n\n- [What is Mail0.io?](#what-is-mail0io)\n- [Why Mail0.io?](#why-mail0io)\n- [Our Mission](#our-mission)\n- [Documentation](#documentation)\n- [Roadmap 🛤️](#roadmap-️)\n  - [1. Core Email Connectivity](#1-core-email-connectivity)\n  - [2. Email Usage Improvements](#2-email-usage-improvements)\n  - [3. Infrastructure](#3-infrastructure)\n- [Development Priorities](#development-priorities)\n- [Join the Movement 🚀](#join-the-movement-)\n  - [Stay Tuned](#stay-tuned)\n- [Tech Stack](#tech-stack)\n- [Getting Started](#getting-started)\n  - [Prerequisites](#prerequisites)\n  - [Environment Variables](#environment-variables)\n  - [Running Locally](#running-locally)\n- [Contribute](#contribute)\n- [Issues](#issues)\n  - [Create a new issue](#create-a-new-issue)\n  - [Solve an issue](#solve-an-issue)\n- [Pull Request](#pull-request)\n- [License](#license)\n\n## What is Mail0.io?\n\nMail0.io is an open-source email solution that gives users the power to **self-host** their own email app while also integrating external services like Gmail and other email providers. Our goal is to put **control, privacy, and customization** back into the hands of users—whether they choose to host their email independently or manage multiple inboxes from a single, customizable platform.\n\n## Why Mail0.io?\n\nMost email services today are either **closed-source**, **data-hungry**, or **too complex to self-host**. Mail0.io is different:\n\n✅ **Fully Open-Source** – No hidden agendas, no walled gardens. 100% transparency.\n🔒 **Data Privacy First** – Your emails, your data. No tracking, no selling, no middlemen.\n⚙️ **Self-Hosting Freedom** – Run your own email app with ease.\n📬 **Unified Inbox** – Connect multiple email providers like Gmail, Outlook, and more.\n🎨 **Customizable UI \u0026 Features** – Tailor your email experience the way you want it.\n🚀 **Developer-Friendly** – Built with extensibility and integrations in mind.\n\n## Our Mission\n\nWe believe email should be:\n\n1. **Yours** – You control where your data is stored.\n2. **Flexible** – Use it however you want—self-hosted or connected to third-party providers.\n3. **Open** – Transparent development, open collaboration, and community-driven innovation.\n4. **User-Friendly** – No need for technical expertise to get started.\n\n## Documentation\n\n- [License](LICENSE) - Project license and terms\n- [Roadmap](ROADMAP.md) - Development plans and future features\n\n## Roadmap 🛤️\n\nThis document outlines the development roadmap for Mail0.io. Our vision is to create a powerful, user-friendly, and privacy-focused email experience.\n\n### 1. Core Email Connectivity\n\n- Connect main email providers\n- Support for multiple email accounts\n- Unified inbox experience\n\n### 2. Email Usage Improvements\n\n- AI-powered email assistance\n- Advanced drag-and-drop tools\n- Customizable keyboard shortcuts\n- Performance optimization\n- Enhanced search capabilities\n- Deep customization options\n\n### 3. Infrastructure\n\n- Domain management\n- Optimized email client\n- Self-hosting capabilities\n\n## Development Priorities\n\n1. Building a robust foundation for email management\n2. Implementing user-requested features\n3. Ensuring seamless integration with existing email providers\n4. Maintaining high performance and reliability\n\nWe welcome community input and contributions to help shape these features and priorities. If you have suggestions or would like to contribute, please:\n\n1. Open an issue to discuss new feature ideas\n2. Submit pull requests for improvements\n3. Join discussions in existing issues\n\nThis roadmap is a living document and will be updated as development progresses and priorities evolve based on community feedback and technological advances.\n\n## Join the Movement 🚀\n\nMail0.io is not just another email app—it's a **vision** for a better, more open, and user-controlled email ecosystem. If you believe in **privacy**, **open-source software**, and **giving users control**, we'd love for you to join us!\n\n📢 **Follow our progress** – Stay updated on GitHub as we build Mail0.io.\n💡 **Contribute** – Share your ideas, suggest features, and help shape the project.\n🤝 **Community-driven** – Our goal is to create an email solution **for the people, by the people**.\n\n### Stay Tuned\n\nWe're just getting started. If you're excited about a future where **email belongs to users, not corporations**, let's make it happen together.\n\n---\n\n🤍 **Mail0.io – Email, Reimagined.**\n\n## Tech Stack\n\nMail0.io is built with modern and reliable technologies:\n\n- **Frontend**: Next.js, React, TypeScript, TailwindCSS, Shadcn UI\n- **Backend**: Node.js, Drizzle ORM\n- **Database**: PostgreSQL\n- **Authentication**: Better Auth, Google OAuth\n\u003c!-- - **Testing**: Jest, React Testing Library --\u003e\n\n## Getting Started\n\n### Prerequisites\n\n**Required Versions:**\n\n- Node.js \u003e= 18.0.0\n- pnpm \u003e= 8.0.0\n- Docker \u003e= 20.10.0\n\nBefore running the application, you'll need to set up several services and environment variables:\n\n1. **Setup Local Services with Dev Container and Docker**\n\n   - Make sure you have [Docker](https://docs.docker.com/get-docker/), [NodeJS](https://nodejs.org/en/download/), and [pnpm](https://pnpm.io/installation) installed.\n   - Open codebase as a container in [VSCode](https://code.visualstudio.com/) or your favorite VSCode fork.\n   - Run the following commands in order to populate your dependencies and setup docker\n\n     ```\n     pnpm install\n     pnpm docker:up\n     ```\n\n   - Run the following commands to clean up after yourself\n\n     ```\n     pnpm docker:down\n     rm -rf node_modules\n     rm pnpm-lock.yaml\n     ```\n\n   - Run the following commands if you are unable to start any of the services\n\n     ```\n     rm -rf node_modules\n     rm pnpm-lock.yaml\n     ```\n\n2. **Better Auth Setup**\n\n   - Open `.env` and change the BETTER_AUTH_SECRET to a random string. (Use `openssl rand -hex 32` to generate a 32 character string)\n\n     ```env\n     BETTER_AUTH_SECRET=your_secret_key\n     ```\n\n3. **Google OAuth Setup**\n\n   - Go to [Google Cloud Console](https://console.cloud.google.com)\n   - Create a new project\n   - Add the following APIs to your Google Cloud Project: [People API](https://console.cloud.google.com/apis/library/people.googleapis.com), [Gmail API](https://console.cloud.google.com/apis/library/gmail.googleapis.com)\n     - Use links above and click 'Enable' or\n     - Go to 'APIs and Services' \u003e 'Enable APIs and Services' \u003e Search for 'Google People API' and click 'Enable'\n     - Go to 'APIs and Services' \u003e 'Enable APIs and Services' \u003e Search for 'Gmail API' and click 'Enable'\n   - Enable the Google OAuth2 API\n   - Create OAuth 2.0 credentials (Web application type)\n   - Add authorized redirect URIs:\n     - Development:\n       - `http://localhost:3000/api/auth/callback/google`\n       - `http://localhost:3000/api/v1/mail/auth/google/callback`\n     - Production:\n       - `https://your-production-url/api/auth/callback/google`\n       - `https://your-production-url/api/v1/mail/auth/google/callback`\n   - Add to `.env`:\n\n     ```env\n     GOOGLE_CLIENT_ID=your_client_id\n     GOOGLE_CLIENT_SECRET=your_client_secret\n     GOOGLE_REDIRECT_URI=http://localhost:3000/api/v1/mail/auth/google/callback\n     ```\n\n   - Add yourself as a test user:\n\n     - Goto [`Audience`](https://console.cloud.google.com/auth/audience)\n     - Under 'Test users' click 'Add Users'\n     - Add your email and click 'Save'\n\n\u003e [!WARNING]\n\u003e The `GOOGLE_REDIRECT_URI` must match **exactly** what you configure in the Google Cloud Console, including the protocol (http/https), domain, and path - these are provided above.\n\n4. **Github OAuth Setup**\n\n   - Go to [Github Developer Setting](https://github.com/settings/developers)\n   - Create a new OAuth Apps\n   - Add authorized redirect URIs:\n\n     - Development:\n       - `http://localhost:3000/api/auth/callback/github`\n     - Production:\n       - `https://your-production-url/api/auth/callback/github`\n\n   - Add to `.env`:\n\n     ```env\n     GITHUB_CLIENT_ID=your_client_id\n     GITHUB_CLIENT_SECRET=your_client_secret\n     ```\n\n### Environment Variables\n\nCopy `.env.example` to `.env` and configure the following variables:\n\n```env\n# Auth\nBETTER_AUTH_SECRET=     # Required: Secret key for authentication\n\n# Google OAuth (Optional)\nGOOGLE_CLIENT_ID=       # Required for Gmail integration\nGOOGLE_CLIENT_SECRET=   # Required for Gmail integration\nGOOGLE_REDIRECT_URI=    # Required for Gmail integration\n\n# Database\nDATABASE_URL=          # Required: PostgreSQL connection string\n```\n\n### Update the PostgreSQL database accordingly\n\nDrizzle will apply the schema migrations set in `.env`\n\n```bash\npnpm db:push\n```\n\n- Use `pnpm db:studio` to view and manage your data\n\n### Running Locally\n\nRun the development server:\n\n```bash\npnpm dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) with your browser to see the result.\n\n## Contribute\n\n1. You can fork the repository and make your changes on your forked repository. Once you have made your changes, you can create a pull request to the main branch.\n2. To add code to the main branch, make a [pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request). **Your code should always be reviewed by a partner, not yourself!**\n\n## Issues\n\n### Create a new issue\n\nIf you spot a problem with the docs, [search if an issue already exists](https://docs.github.com/en/github/searching-for-information-on-github/searching-on-github/searching-issues-and-pull-requests#search-by-the-title-body-or-comments). If a related issue doesn't exist, you can open a new issue using a relevant [issue form](https://github.com/nizzyabi/Mail0/issues/new?template=Blank+issue).\n\n### Solve an issue\n\nScan through our [existing issues](https://github.com/nizzyabi/Mail0/issues) to find one that interests you. You can narrow down the search using `labels` as filters. See \"[Label reference](https://docs.github.com/en/contributing/collaborating-on-github-docs/label-reference)\" for more information. As a general rule, we don't assign issues to anyone. If you find an issue to work on, you are welcome to open a PR with a fix.\n\n## Pull Request\n\nWhen you're finished with the changes, create a pull request, also known as a PR.\n\n- Fill the \"Ready for review\" template so that we can review your PR. This template helps reviewers understand your changes as well as the purpose of your pull request.\n- Don't forget to [link PR to issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue) if you are solving one.\n- Enable the checkbox to [allow maintainer edits](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork) so the branch can be updated for a merge.\n  Once you submit your PR, a reviewer will review your proposal. We may ask questions or request additional information.\n- We may ask for changes to be made before a PR can be merged, either using [suggested changes](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request) or pull request comments. You can apply suggested changes directly through the UI. You can make any other changes in your fork, then commit them to your branch.\n- As you update your PR and apply changes, mark each conversation as [resolved](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request#resolving-conversations).\n- If you run into any merge issues, checkout this [git tutorial](https://github.com/skills/resolve-merge-conflicts) to help you resolve merge conflicts and other issues.\n\n## License\n\nMail0.io is licensed under the MIT License. This means you can:\n\n✅ Use the software commercially\n✅ Modify the source code\n✅ Distribute your modifications\n✅ Use and modify the software privately\n\nThe only requirement is that you include the original copyright and license notice in any copy of the software/source.\n\nSee the [LICENSE](LICENSE) file for the full license text.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMail-0%2FMail-0","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMail-0%2FMail-0","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMail-0%2FMail-0/lists"}