Skip to content
CAI
Software that uses CAICheck a score

antoinechalifour/remix-hexagonal-architecture

50.4

Adequate · 9 November 2026

6.4k

lines of production code

TypeScript

primary language

6

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

This system is a collaborative todo list management application built on a hybrid architecture combining Remix for the frontend and NestJS for the backend. It enables users to create, organize, and share todo lists with real-time synchronization via Server-Sent Events, supporting features like drag-and-drop reordering, tag filtering, and permission-based access control. The platform handles full user account lifecycles, including registration, email verification, and password recovery, while maintaining an audit trail of changes through domain events.

Features

Add dedicated route for rendering individual todo lists with drag-and-drop support

A new route at app/routes/l/$todoListId.tsx has been added to render individual todo list pages. This page loads the specific todo list details via a loader, displays the list using a dedicated TodoList component, and wraps the UI with Recoil for state management and React DnD (HTML5 backend) to enable drag-and-drop interactions for managing items within the list.

app/routes/l · high confidence

Added email sending infrastructure with SendGrid integration

The application now includes a new mail service layer in the shared module, enabling email functionality. This introduces a \Mailer\ interface and a concrete \SendGridMailer\ implementation that uses the SendGrid API for sending transactional emails via dynamic templates. A \FakeMailer\ is also provided for testing or non-production environments, and the necessary \Mail\ data structure is defined to support template-based messaging.

src/shared/mail · high confidence

Added time abstraction for deterministic testing

A new shared time module has been introduced, providing a \Clock\ interface along with \RealClock\ (wrapping \new Date()\) and \FixedClock\ (returning a static date). This allows consumers to inject a controllable time source, enabling deterministic behavior in tests and decoupling logic from the system clock.

src/shared/time · high confidence

Application services for todo and todo list management

The application layer now exposes dedicated services for managing individual todos and todo lists. TodoApplicationService handles operations such as adding, deleting, marking as complete, renaming, and tagging todos, while TodoListApplicationService manages the creation, archiving, and renaming of todo lists, as well as reordering items and managing user access (granting and revoking permissions). Both services orchestrate their respective use cases within database transactions and publish domain events.

src/todo-list-manager/application · high confidence

Application wiring for Remix and NestJS integration

The \src/web\ module now provides the core application wiring that integrates the Remix frontend with the NestJS backend. This includes the \ApplicationModule\ which configures authentication services, todo-list management repositories, and event handling, alongside the \RemixController\ and \RemixAppContext\ to serve the Remix application. The module also handles dynamic configuration for mailers (SendGrid or fake) and session management based on environment variables.

src/web · high confidence

Authentication application service and email event consumer introduced

The authentication application layer now exposes an \AuthenticationApplicationService\ that orchestrates login, registration, account verification, and password reset flows by delegating to specific use-case classes and handling domain errors with user-friendly messages. Additionally, an \AuthenticationEventsConsumer\ listens for domain events (user registration, password forgotten, password changed) and sends corresponding transactional emails using configured template IDs and a base URL from environment variables.

src/authentication/application · high confidence

Homepage now displays owned and shared todo lists with permission-based archiving

The homepage has been restructured to present two distinct sections: 'Your todo lists' (owned) and 'Shared with you' (contributed). Each list item displays the title, item count, and modification date, and includes an archive button that is only visible if the user has archive permissions. Users can also create new todo lists via a dedicated form on the homepage.

app/homepage · high confidence

Implement database persistence and querying for todo lists, items, and permissions

This change introduces the infrastructure layer for the todo-list-manager, adding database repositories and queries that persist todo lists, individual todos (including tags and completion status), and list permissions (owner and contributors). It also adds a contributors adapter to resolve user details by ID or email, and an event repository to store and publish todo-list domain events, enabling the application to read, save, and query todo data and access controls in the database.

src/todo-list-manager/infrastructure · high confidence

Initial Remix application shell with accessibility and error handling

The app directory now contains the core structure for a Remix-based application, including server-side rendering entry points, a root layout component, and client hydration logic. This change introduces a dedicated error boundary that displays user-friendly messages for 404s and unexpected errors, along with a favicon set. Additionally, it adds a RouteChangeAnnouncement component to improve accessibility by announcing page title changes to screen readers, and includes utility functions for date formatting and color palette generation.

app · high confidence

Initial export of Todo List Manager module

The src/todo-list-manager location now exposes the core application services (TodoListApplicationService, TodoApplicationService), domain errors (TodoListNotFoundError, TodoListPermissionDeniedError, ContributorNotFoundError), and infrastructure components (repositories, queries, and the ContributorsAdapter) via a central index file.

src/todo-list-manager · high confidence

Initial project scaffolding and configuration

The repository is initialized with the foundational configuration files required to run the application. This includes a Dockerfile and docker-compose.yml to set up PostgreSQL databases for development, integration, and E2E testing, alongside a Procfile for Heroku deployment. The project is configured as a hybrid Remix and NestJS application, with specific settings for Tailwind CSS (including custom colors and animations), ESLint, Jest, and TypeScript path mappings. Additionally, standard boilerplate files such as .gitignore, .dockerignore, LICENSE, and README.md are added to support development workflows and documentation.

(repo-wide) · high confidence

Introduce account registration, verification, and password reset domain logic

The authentication domain now supports creating unverified accounts, verifying them via a token, and resetting passwords through an expiring token. Account registration normalizes emails to lowercase, and the domain defines specific error types for invalid or expired tokens, as well as events for user registration, password changes, and password resets.

src/authentication/domain · high confidence

Introduce shared ID generation abstraction

The \src/shared/id\ module now provides a standardized interface for generating unique identifiers. It includes a \GenerateId\ interface, a production-ready \GenerateUUID\ implementation using the \uuid\ library, and a \GenerateTestId\ implementation for deterministic, prefixed IDs in test environments. This allows other parts of the application to depend on a consistent ID generation strategy that can be easily swapped or mocked.

src/shared/id · high confidence

Introduce shared Prisma database integration layer

The application now includes a shared database module that provides a NestJS-compatible Prisma client service and an abstract repository base class. The Prisma service handles automatic database connection initialization via the OnModuleInit lifecycle hook, while the PrismaRepository base class offers dependency injection for the Prisma client and a utility method to detect unique constraint violations (error code P2002), simplifying data access patterns across the codebase.

src/shared/database · high confidence

Introduce shared client data transfer objects for todo lists and authentication

This change introduces a new set of TypeScript interfaces in the shared client layer to define the data structures exchanged between the client and server. It adds DTOs for authentication errors, home page summaries (including owned and contributed lists with specific permissions like archive and leave), todo items (distinguishing between 'doing' and 'done' states), and detailed todo list pages (including versioning, completion percentages, and contributor roles such as 'owner' or 'contributor'). These types standardize the client-side contract for displaying todo lists, managing permissions, and handling user authentication errors.

src/shared/client · high confidence

Introduce shared event infrastructure with NestJS integration

The application now includes a shared event system in src/shared/events, providing a base Event class that automatically generates unique IDs and records publication timestamps. This infrastructure introduces a generic Events interface and two concrete implementations: NestEvents, which integrates with NestJS's EventEmitter2 for production use, and CollectEvents, a simple in-memory collector likely intended for testing or local development. The index file exports these components, establishing the foundation for event-driven communication within the codebase.

src/shared/events · high confidence

Introduces NestJS-backed Remix integration with session-based authentication

The application now bridges Remix and NestJS by routing all requests through a NestJS controller that injects Actions and Loaders into the Remix context. This enables server-side session management via a new SessionManager and provides an Authenticated decorator to protect routes, automatically redirecting unauthenticated users to login. Users can now log in, register, and verify their accounts, with error messages displayed via session flash data, and authenticated users can manage their todo lists through the integrated action handlers.

src/web/remix · high confidence

New Remix decorators for parameter binding and error mapping

Added a set of TypeScript decorators in src/web/remix/decorators to simplify Remix data function handling. The @Body, @Params, and @Query decorators automatically parse and validate request payloads using class-validator and class-transformer, while the @DataFunction decorator orchestrates this parsing and returns structured validation errors. Additionally, @MapErrorThrowing and @MapErrorReturning allow developers to map specific custom errors to standardized JSON responses with defined HTTP status codes.

src/web/remix/decorators · high confidence

New UI component library with Radix primitives and Tailwind styling

The app/ui directory now provides a comprehensive set of reusable UI components built on Radix UI primitives and styled with Tailwind CSS. This includes accessible primitives like Checkbox, Dialog, Popover, and Tooltip, alongside application-specific components such as Button variants (Primary, Secondary, Plain), FloatingLabelInput with validation states, EditableContent for inline editing, and layout helpers like RootLayout and SkipToContent. These components standardize the visual design and interaction patterns across the application.

app/ui · high confidence

New authentication and onboarding routes

The application now exposes dedicated pages for user onboarding and account management, including login, registration, password reset, forgot password, account verification, and logout. These routes wire up the corresponding UI components (LoginForm, RegisterForm, ResetPasswordForm, etc.) to the backend actions and loaders via the RemixAppContext, and include meta tags for SEO and error handling boundaries for password reset and account verification flows.

app/routes · high confidence

New authentication infrastructure components for account management and session status

This change introduces three new infrastructure classes in the authentication module: AccountDatabaseRepository, BCryptPasswordHasher, and FetchAuthenticationStatusSessionQuery. The AccountDatabaseRepository implements the Accounts domain interface, providing methods to retrieve verified, unverified, and password-reset accounts by email (using case-insensitive lookup), and to save these account states while handling unique constraint errors. The BCryptPasswordHasher implements the PasswordHasher interface, using bcrypt with a cost factor of 10 for hashing and verifying passwords. The FetchAuthenticationStatusSessionQuery implements the FetchAuthenticationStatus interface, delegating to an injected Authenticator to determine if a user is currently authenticated.

src/authentication/infrastructure · high confidence

New authentication use cases for account lifecycle management

This change introduces five new use-case classes in the authentication module to handle core account operations: RegisterFlow for creating new accounts, LoginFlow for authenticating users, VerifyAccount for confirming email addresses, ForgotPassword for initiating password resets, and ResetPassword for completing the password reset process. These use cases orchestrate interactions with the domain layer (Accounts, PasswordHasher) and publish domain events (UserRegistered, PasswordForgotten, PasswordChanged) to support the broader authentication feature set.

src/authentication/usecase · high confidence

New shared utility for moving array items

A new shared library module has been introduced to provide a reusable utility for manipulating arrays. Specifically, the \moveArrayItem\ function allows users to move an element from one index to another within an array, returning a new array with the item repositioned. This functionality is now available for import across the application via the \src/shared/lib\ entry point.

src/shared/lib · high confidence

New todo list sharing and management UI

This change introduces a new user interface for managing todo list sharing and contributors. Users can now view current collaborators via avatar pins in the header, add new contributors through a dedicated form, and revoke access for existing contributors. The sharing dialog also displays the list of current collaborators. Additionally, the todo list header now includes a completion progress bar and the ability to edit the list title inline. The 'Add Todo' form and tag filters are also present in the header area, providing a consolidated view for list management.

app/todolist/Sharing · high confidence

Real-time todo list updates via Server-Sent Events

Users can now subscribe to live updates for a specific todo list using Server-Sent Events (SSE). A new controller at /events/l/:todoListId streams domain events (such as additions, updates, deletions, and reordering) to the client in real time, ensuring the UI stays synchronized with the latest state without requiring manual refreshes. The connection includes a 30-second heartbeat to maintain stability and prevent idle connection timeouts.

src/web/controllers · high confidence

Todo List Manager domain model and event schema

This change introduces the core domain model for the Todo List Manager, defining the structure for Todo items (including title, completion state, and a maximum of three tags), Todo Lists (with explicit ordering), and Contributors. It establishes a permission system distinguishing between owners and contributors, enforcing access controls for actions like archiving, editing, and sharing. Additionally, it defines a comprehensive set of domain events (such as TodoAdded, TodoReordered, and TodoListAccessGranted) to track state changes and collaboration activities within the system.

src/todo-list-manager/domain · high confidence

Todo list management use cases now publish domain events

The use cases in the todo-list-manager (such as CreateTodoList, AddTodoToTodoList, MarkTodo, and UpdateTodoListTitle) now publish specific domain events (e.g., TodoListCreated, TodoAdded, TodoCompletionChanged) upon execution. This change enables external systems to react to todo list modifications, such as archiving, reordering, or permission changes, by listening to these published events.

src/todo-list-manager/usecase · high confidence

Behavioural changes

Account verification status is now explicit rather than defaulting to verified

The database schema for the Account model has been updated to support explicit verification tracking. A new 'verificationToken' column and a 'verified' boolean column were added to the Account table. Subsequently, the default value for the 'verified' column was removed, meaning new accounts will no longer automatically be marked as verified upon creation; the status must now be explicitly set.

_prisma/migrations/20220521090745\_add\_account\_verification, prisma/migrations/20220521090857\_remove\_default\_verification\status · high confidence

Authentication module restructured with new domain and infrastructure exports

The authentication module has been reorganized to expose a cleaner public API, exporting core application services, domain entities, specific error types, and infrastructure implementations directly from the main index. This change consolidates the module's surface area, making components like the authentication application service, account database repository, and password hasher more accessible to other parts of the system without requiring deep import paths.

src/authentication · high confidence

Configurable session settings and application bootstrap

The application now supports configurable session settings, including name, max age, httpOnly, sameSite, and secrets, which are passed via the ApplicationModule registration. The bootstrap process initializes the NestJS application with these session configurations and sets up the Remix handler path. Additionally, the main entry point now explicitly disables the body parser for the NestJS application.

src · high confidence

Database schema migration to PostgreSQL with enhanced collaboration and audit features

The application database has been migrated to PostgreSQL, introducing a refined schema that supports advanced collaboration and auditing capabilities. User accounts now include password reset tokens and verification status, with unique constraints on email addresses. Todo lists have been decoupled from direct owner references in favor of a dedicated \TodoListPermission\ table, which tracks the owner and a list of contributors (collaborators) via JSON arrays, enabling shared access control. Additionally, the schema supports task ordering and tagging through JSONB columns, records when tasks are completed, and introduces a \TodoListEvent\ table to persist a history of changes to lists, ensuring auditability and supporting features like drag-and-drop reordering.

prisma · high confidence

Enable React Fast Refresh in Recoil for development

A patch applied to Recoil v0.7.3 modifies the \isFastRefreshEnabled\ function across its CommonJS, ES, Native, and UMD entry points to return \true\ instead of \false\. This change enables React Fast Refresh support within the Recoil state management library during development, allowing for faster and more reliable hot reloading of stateful components without losing application state.

patches · high confidence

Extracted granular action handlers for todo list operations

The route handlers in the todo list section have been refactored to expose specific endpoints for individual operations, including archiving the list, granting or revoking access, reordering items, and managing individual todos (marking, updating titles, adding/removing tags, and deletion). Each new file delegates its logic to the corresponding method on the application context's actions object, providing a more modular structure for handling these user interactions.

app/routes/l/$todoListId · high confidence

New global styles with Tailwind and focus ring

The application now uses a new \styles/app.css\ file that initializes Tailwind CSS and defines global base styles. This includes loading the Metropolis font, setting the default text color and font family, and applying a consistent dashed focus ring to all focus-visible elements to improve keyboard accessibility.

styles · high confidence

Redesigned authentication flows with unified form styling and password confirmation

The authentication experience has been restructured into separate, dedicated forms for login, registration, and password recovery, all sharing a unified card-based design via the new FormCard component. Registration and password reset now require users to confirm their password, with real-time matching validation provided by the new usePasswordConfirmation hook. The login form includes a submission spinner to indicate processing, while the forgot-password flow now displays a confirmation notification upon submission. Account verification and welcome states are presented using a new InfoPageTemplate with distinct icons and messaging.

app/authentication · high confidence

Reorders todo lists to exclude completed items

The database schema migration updates the \todosOrder\ field in the \TodoList\ table. It recalculates the order of todos by filtering out any items marked as complete (\isComplete = false\), ensuring that the stored order reflects only the active, unfinished tasks.

_prisma/migrations/20220604185050\_remove\_complete\_todos\_from\order · high confidence

Structured input validation for todo and authentication actions

The application now enforces strict validation on user inputs for todo management and account operations. Todo list titles and individual todo titles are limited to 50 characters, while tags are restricted to 15 characters. Password fields for login, registration, and password reset require a minimum length of 8 characters and a maximum of 64 characters. Email addresses are validated for proper format, and todo completion status is restricted to specific values ('on' or 'off'). These changes ensure that data submitted to the server meets defined constraints before processing.

src/web/remix/dtos · high confidence

Todo item interactions refactored into a popover menu and drag-and-drop reordering

The TodoItem component has been restructured to improve usability and code organization. A new popover menu (accessed via the three-dot icon) now groups secondary actions, including adding/removing tags, archiving the todo, and moving it to the top or bottom of the list. The list title is now editable inline, with the entire item becoming read-only when the todo list is stale. Additionally, todos can now be reordered via drag-and-drop using a dedicated handle, providing visual feedback during the move.

app/todolist/TodoItem · high confidence

Todo list now supports tag filtering, drag-and-drop reordering, and stale-data detection

The TodoList page now allows users to filter tasks by tags, with the list count updating to show how many items match the selection. Users can reorder 'Things to do' items via drag-and-drop, with a live preview of the new order; this interaction is disabled if the list is marked as stale or if a tag filter is active. A new 'TodoListOutdatedMessage' component appears when the list is stale, prompting the user to refresh. The underlying state management has been migrated to Recoil to support these interactive features.

app/todolist · high confidence

Test coverage

Added integration tests for todo-list-manager persistence layer; Added test infrastructure for authentication domain; Added tests for todo-list-manager use cases; Initial Cypress end-to-end test suite for todo management.

Dependencies

Initial dependency setup for Remix and NestJS application

The project now includes a \package.json\ and \yarn.lock\ file, establishing the foundational dependencies for the application. This adds the core runtime libraries for a full-stack architecture combining NestJS (v8.4.4) for the backend and Remix (v1.5.1) for the frontend, alongside Prisma (v3.8.1) for database management. It also introduces UI components via Radix UI, state management with Recoil, drag-and-drop functionality using React DnD, and styling with Tailwind CSS. Development tooling is configured with ESLint, Jest, Cypress, and TypeScript, along with build scripts to orchestrate the separate frontend and backend build processes.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 52 → 50 (-1.2)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 92 → 92 (+0.0)
  • Architecture 86 → 86 (+0.1)
  • Maturity 46 → 43 (-3.2)
  • Readiness 50 → 50 (+0.0)
  • Security 50 → 51 (+1.6)
  • Domain Modelling 70 → 70 (+0.0)
  • Accessibility 63 → 63 (+0.0)
  • Performance 100 → 100 (+0.0)

Resolved (15)

  • Boundary-crossing change coupling: AddTodoListForm.tsx ↔ AddTodoForm.tsx (app/homepage/AddTodoListForm.tsx)
  • Boundary-crossing change coupling: AddTodoListForm.tsx ↔ TodoItem.tsx (app/homepage/AddTodoListForm.tsx)
  • Change coupling: TodoItem.tsx ↔ AddTodoForm.tsx (app/todolist/TodoItem/TodoItem.tsx)
  • Change coupling: TodoList.tsx ↔ AddTodoForm.tsx (app/todolist/TodoList.tsx)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High CVE: [GHSA redacted] (yarn.lock)
  • Medium CVE: [GHSA redacted] (yarn.lock)
  • Medium CVE: [GHSA redacted] (yarn.lock)
  • Medium CVE: [GHSA redacted] (yarn.lock)

New (12)

  • Change coupling clique: AddTodoListForm.tsx, TodoItem.tsx, AddTodoForm.tsx (app/homepage/AddTodoListForm.tsx)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High CVE: [GHSA redacted] (yarn.lock)
  • Low CVE: [GHSA redacted] (yarn.lock)
  • Medium CVE: [GHSA redacted] (yarn.lock)
  • Medium CVE: [GHSA redacted] (yarn.lock)

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

antoinechalifour/remix-hexagonal-architecture was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 9 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit df94d98bcccf5b4d87aa5792ac8642e7b3816f5d — the exact code this score is about.
  • Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-bb0cb800cd0f.