Other libraries

dayjs

Is our preferred date library due to its lightweight nature and simplicity. It provides a straightforward functions for date and time manipulation, without the bloat of larger libraries like Moment.js. Day.js is also immutable, meaning it prevents accidental changes to dates, improving the reliability of our date operations. Its plugin architecture lets us add functionality only when we need it, keeping our codebase clean and performant.

mjml

Is our choice for creating responsive and consistent email templates. It provides a markup language that simplifies building emails, abstracting complex HTML/CSS into reusable components that look good across email clients. This enables us to design emails efficiently without worrying about compatibility issues, as MJML takes care of rendering code that works well on various devices and platforms.

handlebars

Is our templating engine for rendering dynamic content, especially useful in generating email templates and HTML views. It’s simple yet powerful, allowing us to create templates with placeholders that can be replaced with actual data at runtime. Handlebars improves code readability and reusability, making it easy to maintain and scale our template logic across the project.

@nestjs/swagger

API Documentation: To make our APIs easy to use and understand, we utilize Swagger for documentation. Most of the documentation is automatically generated based on API property definitions, reducing the need for manual documentation. This ensures that our API docs are always up-to-date with the latest changes. The documentation is accessible at the endpoint /api/docs, making it easy for developers and stakeholders to reference and understand available endpoints.

'eslint'

Every project uses the same Eslint Config. This is to ensure that all projects are consistent and that we don't have to spend time on code style.

Helpers and Utilities

We created some packages for validators & decorators that we repeatedly use in our projects. These packages are created to be able to maintain the same code quality and standards across all projects.

• @wisemen/decorators: Contains decorators that we use in our projects. For example, the @UuidParam decorator that we use to validate uuid params.
• @wisemen/validators: Contains validators that we use in our projects. For example, the @IsAfterDateString validator that we use to validate if a date is after a certain date.

Exhaustive Checks

The template enforces exhaustive checks in switch statements, preventing unintentional fall-through cases by triggering IDE errors if any case is unhandled. This ensures that all potential cases are accounted for, adding a layer of safety to our code logic.

Pagination and Query Utilities

Pagination Setup

A standardized pagination system is included within /utils/pagination. This enables consistent pagination for API responses, making frontend interactions more predictable and manageable. The pagination setup also includes configurations for:

Sorting: Enables ordering of results based on specified fields.

Filtering: Allows users to filter data based on various criteria, making it easy to retrieve relevant data subsets.

Search: Adds simple text search capabilities, helping users find specific data within large datasets.

Query Setup: Located in /utils/query, the query utility ensures that all queries are built correctly, improving consistency and reducing redundancy in our codebase. This centralized query setup allows for easier maintenance and scaling.