Onyx Backend API

Module-based REST API built with Node.js, Express 5, Sequelize (MySQL), Redis, RabbitMQ, MinIO, and Socket.IO.

Stack

Layer	Technology
Runtime	Node.js 20
Framework	Express 5
ORM	Sequelize 6 + MySQL / MariaDB
Cache	Redis (ioredis)
Queue	RabbitMQ (amqplib)
Storage	MinIO
Mail	Nodemailer via Resend SMTP
Real-time	Socket.IO

Getting Started

cp .env.example .env   # fill in your values
npm install
npm run dev

Health check: GET /health

Docker

docker compose up -d

Environment

See .env.example for all required variables.

Project Structure

app/
├── core/           # Infrastructure, configs, middleware, base classes
│   └── domain/     # Models, enums
├── modules/        # Feature modules (auth, ...)
├── services/       # Notification engine, migration service
└── shared/         # Utilities, static files

License

ISC © hidirektor