Report bug | Request feature | Help issues | 🇨🇳[简体中文]

Email-Dashboard is an easy way to manage your outgoing emails from your apps. From creating and sending your emails to monitoring and managing their stats, you can do really useful things with Email-Dashboard without worried about time zone disaverage. You can 🔗explore Email-Dashboard docs.

💢 Table of content

• For whom?
• Code overview
• Features
• Deployment
  • 1- Debian
• Development
  • 1- MacOS
  • 2- Debian
• Usage
  • 1- In Dashboard
  • 2- Posting to REST API
• Contributing
• Authors
• License
• Acknowledgement

🚻 For whom?

:earth_asia: If you need to send automatic emails without worried about time zone,
🔍 If you need to track your emails and analyse your results to follow better strategies,
📊 If you need to monitoring your activities,
📑 If you want to use email templates,
🕵️ If you need to A/B testing,
💯 And if you want to do all of this easily,

Then you're at the right place. Email Dashboard builded for you! :tada:

:eyes: Code overview

:small_orange_diamond: The REST API builded with superfast language 🔗golang.
:small_orange_diamond: The Dashboard builded with fastest development framework 🔗Rails
:small_orange_diamond: Front-end framework 🔗uikit using in the dashboard.

☑ Features

• Monitor email activities that your service sent.
• Interactive templates.
• Multiple SMTP support.
• Scheduled delivery with time zone.
• Perform / Cancel scheduled activities optionally.
• Mobile UI
• Email tracking.
• A/B testing.

🔱 Deployment

wget -qO- https://get.docker.com/ | sh

sudo usermod -aG docker ${USER}

curl -L "https://github.com/docker/compose/releases/download/1.11.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

 mkdir -p /datadrive/mysql && mkdir -p /datadrive/data/redis

 git clone https://github.com/Email-Dashboard/Email-Dashboard.git

  docker-compose build
  docker-compose up -d

:computer: Development

docker-compose -f docker-compose-dev.yml build
docker-compose -f docker-compose-dev.yml up

docker-compose -f docker-compose-dev.yml build
docker-compose -f docker-compose-dev.yml up

:trophy: Usage

1- In Dashboard

Using dashboard is really easy, like playing PUBG! You can do it any time without any effort. Because our first aim is make some time for our community with our dashboard. So, UI and dashboard is friendly as much as and we will make it better.

:small_orange_diamond: Add your SMTP Settings
:small_orange_diamond: Create email template with 🔗handlebars variables.
:small_orange_diamond: Create notification. See, easy peasy!

2- Posting to REST API

POST https://api.{{yourhost}}/api/v3/notifications/{{notification-slug}}

Authorization: Token {{AccountToken}}

{
   "variables":{
      "button_name": "Click me!",
      "name": "John"
   },
   "email": {
      "to": ["[email protected]", "[email protected]"],
      "cc": ["[email protected]"],
      "reply_to": ["[email protected]"],
      "from": "[email protected]"
   },
   "delivery": { # optional
     "time": "21:00",
     "date": "2018-09-22",
     "zone": "Europe/Istanbul"
   }
}

For more specified usage you can follow 🔗step by step instructions in docs.

💝 Contributing

Please read our 🔗contribution guidelines. We are grateful for all contributions! :pray: With following our 🔗rules of the discussions, you can contribute many of way. Our 🔗issue tracker is the preferred channel for bug reports, features requests and submitting pull requests. We utilized several 🔗labels to help organize and identify issues. You can start with there! Also if you want to add some new feature:

1. Clone or fork the project (git clone https://github.com/Email-Dashboard/Email-Dashboard)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

:mag_right: But before opening a feature request, please take a moment to find out whether your idea fits with the scope and aims of the project. It's up to you to make a strong case to convince the project's developers of the merits of this feature. So, you can provide as much detail and context as possible.

:memo: Authors

Sahin Boydas Product	Muhammet Lead Developer	Sadik Developer	Tommy Yang Developer blog

:mortar_board: License

This program is a free and open source software. You can redistribute it and/or modify it under the terms of the license provided in the 🔗LICENSE file. Use of this software is subject to important terms and conditions as set forth in the 🔗LICENSE file.

:mag: Acknowledgement

If you liked our dashboard, please give us a "Star" :star:. Your support is what keep us moving forward and delivering happiness to you! Thank's a million, you're our Clark Kent/Kara Danvers! In case of any questions or concerns, feel free to contact us anytime. Btw you can see our guilds from our 🔗credit content :blush: