Skip to content

Case Study / Web Application

Adnois API / 5 weeks

AdonisJS REST API Backend

A typed, tested API foundation on AdonisJS — authentication, mail, validation and a MySQL data layer, with a Postman collection ready for integration.

  • Typed End-to-end. TypeScript routes validated by VineJS.
  • 1 Postman collection. Integration-ready API surface.
  • Full Mail & auth. MJML templates and auth guards included.
  • AdonisJS
  • Node.js
  • MySQL
  • Redis
  • MJML
Adnois API — AdonisJS REST API Backend

Overview

Client Overview

Personal project — API backend build

Services provided

  • Custom Software Development
  • Full-Stack Web Development
Client
Personal project — API backend build
Industry
Software
Timeline
5 weeks
Year
2025
Platforms
Web application
Team
1 engineer

Challenge

Business Challenge

The situation before the engagement, in the client's terms.

A backend is only as good as its contract. Adnois had to give a frontend team a typed, validated API with mail and auth — and prove it with tests.

  • 01

    Clear contract

    Typed routes with validation on every payload.

  • 02

    Auth built in

    Guards and roles ready from the start.

  • 03

    Integratable

    A Postman collection for the consuming team.

Objectives

Engagement Objectives

What the build needed to achieve before implementation began.

  • Deliver a typed, validated API contract

  • Include auth, mail and a solid data layer

  • Ship a Postman collection for consumers

  • Back it with tests and linting

Solution Design

How We Solved It

The approach that addressed each challenge above.

AdonisJS provided the structure; the work was in the details — VineJS validation, MJML mail, Redis-backed services and a test suite.

  • 01

    Typed routes

    VineJS validates every request.

  • 02

    Mail done right

    MJML templates render everywhere.

  • 03

    Solid data layer

    Lucid ORM over MySQL, Redis for services.

  • 04

    Ready to consume

    Postman collection ships in the repo.

Capabilities

Key Features

What Adnois API does in day-to-day use.

  • Typed API

    AdonisJS with TypeScript and VineJS-validated routes.

  • Authentication

    Full auth with guards and role handling.

  • MJML email

    Responsive email templates rendered from MJML.

  • MySQL & Redis

    Lucid ORM over MySQL with Redis for sessions or cache.

  • Postman collection

    A ready-made collection for frontend integration.

  • Tested

    Automated tests and linting in the pipeline.

Technology Stack

Technology Stack

  • AdonisJS
  • TypeScript
  • Lucid ORM
  • Adonis auth
  • MySQL
  • Redis
  • SMTP
  • MJML templates
  • Adonis mail
  • VineJS validation
  • Tests
  • CSPELL
  • Postman collection

Outcome

Results & Outcome

What changed for the business after launch.

  • Typed

    End-to-end

    TypeScript routes validated by VineJS.

  • 1

    Postman collection

    Integration-ready API surface.

  • Full

    Mail & auth

    MJML templates and auth guards included.

Interface

A Closer Look

Screens from the delivered system.

  • REST API surface
    AdonisJS routes, typed and validated.
  • Auth & mail services
    Guards, roles and MJML email.
  • Data layer
    Lucid ORM, MySQL and Redis.

Conclusion

The Result

Adnois delivered a typed, tested API foundation — authentication, mail and validation built on AdonisJS with a Postman collection ready for the frontend team to integrate against.

  • Typed End-to-end: TypeScript routes validated by VineJS.
  • 1 Postman collection: Integration-ready API surface.
  • Full Mail & auth: MJML templates and auth guards included.

More work

Related Projects

Other systems built on similar foundations.

  • Abstract layout of a customer relationship platform with linked record panels

    SaaS / AI

    Smart CRM

    A multi-tenant CRM with AI assistance built into the record, summarising history and surfacing the next action for every account.

    • Next.js
    • TypeScript
    • PostgreSQL
    • OpenAI
    • +1

    View Case Study

  • Abstract representation of document parsing into structured candidate profiles

    AI / Web Application

    AI Resume Platform

    A web platform that parses resumes into structured data, matches candidates to roles with an explainable score, and generates tailored documents.

    • Next.js
    • Python
    • FastAPI
    • OpenAI
    • +1

    View Case Study

Next step

Want a System Like This?

Tell us what your business needs to automate and we'll map out a practical build.

hello@thedevrox.comWe reply to every enquiry within one business day.