morningly

morningly copied to clipboard

Morningly

Your open-source newsletter platform. Inspired by Morning Brew
Explore the docs »

View Demo · Report Bug · Request Feature

About The Project

This is an open-source platform to launch your own Morning Brew like newsletter. It has all needed features built-in: creating new issues, web portal, role management, delayed sending, subscribe, unsubscribe, automated market info fetching and other cool stuff.

Originally, I used this project internally to host my own russian-speaking version of Morning Brew. I got around 200 users, send more than 10K emails and more than 60% opening rate, so this platform is quite real world tested :)

Built With

Technology stack is actually pretty simple. It is all powered by Django.

Getting Started

Prerequisites

To start using this tool, you probably should need Python or Docker.

Installation

Here is the instruction how to start the app using Python:

1. Clone the repo

   git clone https://github.com/garrrikkotua/morningly.git
   

2. Install pip packages

   pip install -r requirements.txt
   

3. Initialize the app with a simple SQLite database

   python manage.py migrate
   

4. Create a superuser for your app

   python manage.py createsuperuser
   

5. Start the app

   python manage.py runserver
   

6. Go to the localhost:8000 to test it!

Usage

To use this app in the production, your probably should get a Mailgun API key. It is the easiest way to send bulk emails.

You can found a template how to configure Mailgun in email_website/prod_settings.py.

Docker, Dokku and Heroku deployment tutorials are to be added soon.

Contact

Igor Kotua - @garrrikkotua - [email protected]

Project Link: https://github.com/garrrikkotua/morningly