{"id":22944272,"url":"https://github.com/199ocero/mailifyflow","last_synced_at":"2026-01-25T01:12:10.565Z","repository":{"id":242091603,"uuid":"801312016","full_name":"199ocero/mailifyflow","owner":"199ocero","description":"An open-source, self-hosted email marketing platform built using Laravel, FilamentPHP, Maizzle, and Amazon SES.","archived":false,"fork":false,"pushed_at":"2024-06-04T14:11:51.000Z","size":1464,"stargazers_count":43,"open_issues_count":0,"forks_count":12,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-10-24T18:53:50.503Z","etag":null,"topics":["amazon-ses","email-marketing","filamentphp","laravel-framework","marketing-automation","marketing-tools","self-hosted"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/199ocero.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"contributing.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-16T01:49:30.000Z","updated_at":"2025-09-23T17:39:52.000Z","dependencies_parsed_at":"2024-06-01T16:56:54.357Z","dependency_job_id":null,"html_url":"https://github.com/199ocero/mailifyflow","commit_stats":null,"previous_names":["199ocero/mailifyflow"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/199ocero/mailifyflow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/199ocero%2Fmailifyflow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/199ocero%2Fmailifyflow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/199ocero%2Fmailifyflow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/199ocero%2Fmailifyflow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/199ocero","download_url":"https://codeload.github.com/199ocero/mailifyflow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/199ocero%2Fmailifyflow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28740592,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T22:12:27.248Z","status":"ssl_error","status_checked_at":"2026-01-24T22:12:10.529Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["amazon-ses","email-marketing","filamentphp","laravel-framework","marketing-automation","marketing-tools","self-hosted"],"created_at":"2024-12-14T14:17:25.316Z","updated_at":"2026-01-25T01:12:10.550Z","avatar_url":"https://github.com/199ocero.png","language":"PHP","funding_links":[],"categories":["Uncategorized"],"sub_categories":["Uncategorized"],"readme":"\n# MailifyFlow\n\nAn open-source, self-hosted email marketing platform built using Laravel, FilamentPHP, Maizzle, and Amazon SES.\n\n## Acknowledgements\n\nA special acknowledgment goes to these remarkable tools, as MailifyFlow owes its existence to their invaluable contribution.\n\n- [Laravel](https://laravel.com/) - favorite PHP framework\n- [FilamentPHP](https://filamentphp.com/) - my go-to admin panel\n- [Maizzle](https://maizzle.com/) - turn TailwindCSS to email ready html/css\n- [Filapanel](https://filapanel.com/) - admin panel generation\n- [SendPortal](https://github.com/mettle/sendportal) - highly inspired by SendPortal\n\n## Features\n\n- Bulk insert subscribers\n- Tags\n- Campaigns\n- Templates\n- Email Providers (SMPT)\n- Email tracking like bounce, complaint, clicks, opens, etc.\n\n\n## Tech Stack\n\nTailwindCSS, Alpine.js, Laravel, and Livewire (TALL)\n\n\n## Requirements\n- Laravel 11+\n- PHP 8.2+\n- Node v20+\n- Composer v2.7+\n## Installation\n\nFollow these steps to set up this project in your local or production environment.\n\nClone the repository:\n```bash\ngit clone https://github.com/199ocero/mailifyflow.git\n```\n\nNavigate to the cloned project directory and install composer and npm:\n```bash\ncomposer install\nnpm install\n```\n\nCopy the `.env.example` file to `.env`:\n```bash\ncp .env.example .env\n```\n\nCopy the `vite.config.js.example` file to `vite.config.js`:\n```bash\ncp vite.config.js.example vite.config.js\n```\n\nConfigure your database settings in the `.env` file: \n```bash\nDB_CONNECTION=mysql\nDB_HOST=127.0.0.1\nDB_PORT=3306\nDB_DATABASE=mailifyflow\nDB_USERNAME=your-mysql-username\nDB_PASSWORD=your-mysql-password\n```\n\nRun the database migrations:\n```bash\nphp artisan migrate\n```\n\nCreate your first user:\n```bash\nphp artisan make:filament-user\n```\n\n\u003e [!IMPORTANT]\n\u003e ***To track email delivery, bounces, clicks, opens, etc., please ensure you add your AWS key, secret, region, and configuration set name in the .env variable. The system is currently configured only for Amazon SES and if you don't want to track any of this and just want to send emails, you can try adding another SMTP server, but I cannot guarantee it will work. See steps below:***\n\nIn your `.env` make sure that you will have to add these variables and its values\n```bash\nQUEUE_CONNECTION=database\nAWS_ACCESS_KEY_ID=your-access-key-id\nAWS_SECRET_ACCESS_KEY=your-secret-access-key\nAWS_DEFAULT_REGION=your-ses-region\nAWS_SES_CONFIGURATION_SET=your-configuration-set-name\nMAILIFYFLOW_NODE_PATH=full-path-to-your-node\n```\n\n**Steps below to configure your Amazon SES and SNS:**\n - Set up your Amazon SES to verify your email address and sending domain.\n - Create your `Configuration Sets` and ensure you select all event destinations like sends, hard bounces, complaints, and etc. to track your emails.\n - Create an SNS topic and choose the standard option.\n - Create a subscription within your selected SNS topic, using `HTTPS` as the protocol. You can use `expose` or `ngrok` to expose your local environment; in production, this is not necessary.\n - Use the exposed URL in the `Endpoint` field of your SNS, appending `/webhooks/ses` at the end.\n\n\u003e [!IMPORTANT]\n\u003e ***Please ensure that you do not disable or cancel your `expose` or `ngrok`, as it needs to listen to all events coming from Amazon SNS. During development, it's crucial to keep it running, but in production, you can turn it off.***\n\n**Steps below create AWS access key, secret access key, and region:**\n - Create an IAM group and assign the `AmazonSESFullAccess` and `AmazonSNSFullAccess` permissions.\n - Create a new IAM user and add them to the group you created.\n - Once the user is created, obtain the access key and secret key, and ensure you use the same region where your Amazon SES is set up.\n\nLastly, the system uses jobs, so you will need to run `php artisan queue:work` for the local environment. For production, you will need to use a tool like `supervisor` and Laravel provides [documentation](https://laravel.com/docs/11.x/queues#running-the-queue-worker) for this. Additionally, the system having scheduled commands and you need to setup your server using the provided [guide.](https://laravel.com/docs/11.x/scheduling#running-the-scheduler)\n\nRun the project in local:\n```bash\nnpm run dev\n```\n\nIf in production, you can build your project using:\n```bash\nnpm run build\n```\n\n## Testing\n\n```bash\nvendor/bin/pest\n```\n\n## Authors\n\n- [Jay-Are Ocero](https://github.com/199ocero)\n- [All Contributors](https://github.com/199ocero/mailifyflow/graphs/contributors)\n\n## Contributing\n\nContributions are always welcome!\n\nSee `contributing.md` for ways to get started.\n\nPlease adhere to this project's `code of conduct`.\n\n\n## Questions\n\nIf you have any questions, please reach out to freelanceocero@gmail.com\n\n\n## License\n\n[GNU GPLv3](https://choosealicense.com/licenses/gpl-3.0/)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F199ocero%2Fmailifyflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F199ocero%2Fmailifyflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F199ocero%2Fmailifyflow/lists"}