Email and Communication Service Setup

[Mkalbani]

Location: microservices/email-service
Labels: microservice, good first issue, NESTJS
Estimated Time: 6 hours
Difficulty: Easy

Description

Build an email service for sending transactional emails, newsletters, and player communications.

Tasks

• Initialize NestJS project in microservices/email-service
• Set up Email, Template, Queue entities
• Integrate email provider (SendGrid/AWS SES)
• Implement template engine (Handlebars)
• Create email queue with retry logic
• Add email sending API endpoints
• Implement unsubscribe management
• Create email delivery tracking
• Add bounce and complaint handling
• Set up Docker configuration

Acceptance Criteria

• Emails sent successfully
• Templates render correctly
• Queue processes reliably
• Unsubscribes respected
• Delivery tracked accurately
• Service runs independently

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 100 Points.

🧑‍💻 Interested in contributing? Apply to work on this issue on Drips Wave, earn points, and receive rewards.

Warning

Only applications submitted via the apply link above will be considered. Please do not apply by commenting on the issue or opening a PR directly.

🤠 Repo maintainers: You can manage this issue's Points and Complexity on your Maintainer Dashboard here. Please keep an eye on applications and respond quickly 💙

ℹ️ Learn more about Drips Wave

[Kessi-ux]

@Kessi-ux has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hello Maintainer,

I would like to work on this issue because I have hands-on experience building microservices with NestJS and developing email and notification systems. I am confident in creating APIs for sending emails, managing unsubscribes, and tracking delivery and bounces. I am comfortable with Dockerizing services and ensuring they run independently, making me well-suited to deliver a robust and scalable email service for this project.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Kessi-ux to this issue.

[Mosas2000]

@Mosas2000 has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

I’ll like to work on this, I’m a fullstack developer with a good track record

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Mosas2000 to this issue.

[Tebrihk]

@Tebrihk has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

good day,i am capable and would love to handle the above issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Tebrihk to this issue.

[JerryIdoko]

@JerryIdoko has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi @MindFlowInteractive Team,

I would like to work on this issue. I have experience with NestJS and building microservices, and I’m confident I can set up the email-service following the requirements.

My proposed approach:

Infrastructure: Initialize the service within microservices/email-service using a clean hexagonal architecture.

Queueing: Implement BullMQ with Redis to handle high-volume mail and ensure reliable retry logic for failed deliveries.

Templating: Integrate Handlebars for dynamic email content, allowing for easy updates to newsletters and transactional mail.

Reliability: Set up webhook endpoints to handle Bounce and Complaint events to protect the sender's reputation.

Containerization: Provide a Dockerfile and update the root docker-compose.yml (if applicable) for seamless local development.

I’ve previously worked on similar backend logic involving smart contracts and system metrics, so I prioritize code readability and robust error handling.

Could you please assign this to me?

ℹ️ Repo Maintainers: To accept this application, review their application or assign @JerryIdoko to this issue.

[gelluisaac]

@gelluisaac has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi Am a software developer can I be assigned this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @gelluisaac to this issue.

[walterthesmart]

@walterthesmart has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi @Mkalbani, I would like to work on this issue.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @walterthesmart to this issue.

[FabianSanchezD]

@FabianSanchezD has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hey! I’m Fabian and I’d like to take this issue. I have experience with services and also implementing SendGrid, so this should be quick.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @FabianSanchezD to this issue.

[caxtonacollins]

@caxtonacollins has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi 👋
I will love to work on this issue please assign

ℹ️ Repo Maintainers: To accept this application, review their application or assign @caxtonacollins to this issue.

[drips-wave]

Congratulations, @Kessi-ux! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on January 31, 2026.

🧑‍💻 @Kessi-ux: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are issued when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[abdegenius]

@abdegenius has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

I have looked into the task and it falls within my skillset, I will love to contribute on this.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @abdegenius to this issue.