Senlo

Abstract

1. Introduction

Senlo is an open-source, developer-first email infrastructure designed to handle the entire lifecycle of your product's emails. It provides the tools to build, manage, and deliver transactional and lifecycle emails without being locked into a specific delivery provider.

The first build compiles the app from source and takes a few minutes. When it finishes, open http://localhost:3000 and create an account — you land in an example project with four ready-made templates you can open in the visual editor right away.

For a production setup on a server, see the VPS Deployment Guide.

2. Objective

Open-source, self-hosted & provider-agnostic email infrastructure.

This project demonstrates how TypeScript, React, Next.js can be applied to a real-world Digital Marketing & SEO problem.

3. Key Features / Modules

• Visual Drag-and-Drop Editor: Build beautiful, responsive templates without writing HTML/MJML.
• API-First Approach: Trigger emails, manage contacts, and track events via a robust REST API.
• Dynamic Personalization: Use merge tags and conditional logic to tailor content for every recipient.
• Template Versioning: Track changes and roll back to previous versions of your email designs.
• Multi-Project Isolation: Manage multiple products or environments (Staging/Production) from a single instance.

4. Technology Stack

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Node.js (LTS) and npm / yarn / pnpm
• VS Code or any code editor
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/IgorFilippov3/senlo.git
cd senlo

git clone https://github.com/IgorFilippov3/senlo.git
cd senlo/deploy/vps
cp env.example .env
sed -i.bak "s|YOUR_AUTH_SECRET_HERE|$(openssl rand -base64 32)|" .env && rm .env.bak
docker compose up -d --build

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Export reports to Google Sheets or PDF
• Schedule weekly automated reports
• Add competitor comparison

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Which marketing or SEO problem does this tool solve?
2. Which data sources or APIs does it use (Search Console, Analytics, social platforms)?
3. Which metrics or KPIs does it report and how are they calculated?
4. How could the output help a business make decisions?
5. How would you schedule it to run automatically?

9. Source Code & License

This project is developed by IgorFilippov3 and published on GitHub under the GNU Affero General Public License v3.0. Please follow the license terms and credit the original author when you use or modify this code.