A full-featured backend for managing blogs, users, comments, notifications, and views — built with NestJS, TypeScript, Prisma, PostgreSQL, Docker, and CI/CD pipelines.

🚧 Note: This project is still ongoing

• Project Summary
• Live Links
• Tech Stack
• Makefile Usage
• CI/CD Pipeline
• How to Run Locally
• Environment Variables
• API Docs
• Future Improvements

This is a scalable, secure backend REST API designed for managing a modern blogging platform with features like:

• User registration, login (password & OAuth2 with Google)
• JWT authentication and authorization with roles (User, Admin, Moderator)
• Email verification and password reset
• Blog creation, publishing, tagging
• Nested comments and replies
• View tracking (authenticated & anonymous)
• Notification system for comments, replies, mentions, and blog publishing
• Extensible profile management for each user

• Live API: https://blog-management-ss4f.onrender.com
• Swagger Docs: https://blog-management-ss4f.onrender.com/docs
• ER Diagram: https://dbdiagram.io/d/Blog-Management-684f7d4b3cc77757c8fa3f12
• GitHub Repo: github.com/shahadathhs/blog-management

• Language: TypeScript
• Framework: NestJS
• ORM: Prisma
• Database: PostgreSQL (hosted on Neon)
• Auth: OAuth2 (Google), JWT
• Containerization: Docker & Docker Compose (using Node.js 22-slim and pnpm)
• CI/CD: GitHub Actions for automated linting, building, Prisma validation, and deployment to Render
• Deployment: Render
• Logging: Winston + Chalk

To simplify development, container management, and common operations, this project provides a Makefile with handy commands. Ensure Docker and Docker Compose are installed.

Use these instead of direct docker or docker-compose commands.

A GitHub Actions workflow (.github/workflows/ci-db-cd.yml) automates:

1. CI Checks (on pull requests):

   • Lint with pnpm lint
   • Format validation with pnpm format
   • Build with pnpm build

2. Prisma Validation (on pull requests after CI):

   • Schema validation (prisma:validate)
   • Client generation (prisma:generate)
   • Schema formatting (prisma:format)

3. Continuous Deployment (on main branch pushes):

   • Triggers a Render deploy hook via a secure secret

This ensures code quality, schema integrity, and automated deployments.

git clone https://github.com/shahadathhs/blog-management.git
cd blog-management

pnpm install
# or
npm install

Create a .env file and copy the content from .env.example:

cp .env.example .env

Update the values accordingly, especially DATABASE_URL, OAuth, and mail credentials.

npx prisma migrate dev --name init

npm run start:dev

Server will be running at http://localhost:8080

# Database
DATABASE_URL="postgres database"

# General
PORT=8080
NODE_ENV="development"

# JWT
JWT_SECRET=your_super_secret
JWT_EXPIRES_IN=1d

# Mail
MAIL_USER=email
MAIL_APP_PASSWORD=app_password

# OAuth
OAUTH_CLIENT_ID=oauth_id
OAUTH_CLIENT_SECRET=oauth_secret

# Frontend URLs
FRONTEND_EMAIL_VERIFY_URL=http://localhost:3000/auth/verify-email
FRONTEND_PASSWORD_RESET_URL=http://localhost:3000/auth/password-reset

Visit Swagger UI: https://blog-management-ss4f.onrender.com/docs

• Admin dashboard (view/edit users, blogs, tags)
• Rate-limiting, throttling, and abuse protection
• Realtime notifications with WebSockets
• AI-generated tags and summaries for blogs
• Markdown/MDX support for blog content
• Support for image uploads via S3 or Cloudinary