Integrate Routes

Mounts newly created routes into src/app.ts with proper dependency injection chain.

Quick Reference

File to modify: src/app.ts When to use: After creating routes with create-routes skill

Prerequisites

Before integrating routes, ensure you have:

•Schema created (src/schemas/{entity}.schema.ts)
•Repository implementation (src/repositories/mockdb/{entity}.mockdb.repository.ts)
•Service created (src/services/{entity}.service.ts)
•Controller created (src/controllers/{entity}.controller.ts)
•Routes created (src/routes/{entity}.router.ts)

Instructions

Step 1: Add Imports

Add imports at the top of src/app.ts:

typescript

// Route factory
import { create{Entity}Routes } from "@/routes/{entity-name}.router";

// Controller
import { {Entity}Controller } from "@/controllers/{entity-name}.controller";

// Service
import { {Entity}Service } from "@/services/{entity-name}.service";

// Repository (choose one based on environment)
import { MockDb{Entity}Repository } from "@/repositories/mockdb/{entity-name}.mockdb.repository";
// OR for production:
// import { MongoDb{Entity}Repository } from "@/repositories/mongodb/{entity-name}.mongodb.repository";

Step 2: Create Dependency Chain

Add the dependency instantiation in the appropriate section of app.ts:

typescript

// =============================================================================
// {Entity} Resource Dependencies
// =============================================================================
const {entity}Repository = new MockDb{Entity}Repository();
// OR for production: const {entity}Repository = new MongoDb{Entity}Repository();

const {entity}Service = new {Entity}Service({entity}Repository);
const {entity}Controller = new {Entity}Controller({entity}Service);

Step 3: Mount Routes

Add the route mounting after other routes:

typescript

// =============================================================================
// Routes
// =============================================================================
// ... existing routes ...

// {Entity} routes
app.route("/{entities}", create{Entity}Routes({ {entity}Controller }));

Step 4: Verify Order

Ensure the following order in app.ts:

•Imports
•App creation (const app = new Hono<AppEnv>())
•Global middleware (CORS, etc.)
•Dependency instantiation
•Route mounting
•Error handler (app.onError(globalErrorHandler))
•Export

Patterns & Rules

Dependency Chain Order

Always create dependencies in this order:

typescript

// 1. Repository (lowest level)
const repository = new MockDbEntityRepository();

// 2. Service (depends on repository)
const service = new EntityService(repository);

// 3. Controller (depends on service)
const controller = new EntityController(service);

// 4. Routes (depends on controller)
app.route("/entities", createEntityRoutes({ entityController: controller }));

Route Path Convention

•Use plural for entity routes: /notes, /users, /projects
•Use kebab-case for multi-word: /course-registrations
•Match the entity name (singular) to path (plural)

Environment-Based Repository

For production-ready code, use environment-based selection:

typescript

import { env } from "@/env";
import { MockDbNoteRepository } from "@/repositories/mockdb/note.mockdb.repository";
import { MongoDbNoteRepository } from "@/repositories/mongodb/note.mongodb.repository";

const noteRepository =
  env.NODE_ENV === "production"
    ? new MongoDbNoteRepository()
    : new MockDbNoteRepository();

Grouping Dependencies

Group related dependencies with comments:

typescript

// =============================================================================
// Note Resource
// =============================================================================
const noteRepository = new MockDbNoteRepository();
const noteService = new NoteService(noteRepository);
const noteController = new NoteController(noteService);

// =============================================================================
// Project Resource
// =============================================================================
const projectRepository = new MockDbProjectRepository();
const projectService = new ProjectService(projectRepository);
const projectController = new ProjectController(projectService);

Complete Example

typescript

import { Hono } from "hono";
import { cors } from "hono/cors";
import type { AppEnv } from "@/schemas/app-env.schema";
import { globalErrorHandler } from "@/errors";

// Route factories
import { createNoteRoutes } from "@/routes/note.router";
import { createProjectRoutes } from "@/routes/project.router";
import { createEventsRoutes } from "@/routes/events.router";

// Controllers
import { NoteController } from "@/controllers/note.controller";
import { ProjectController } from "@/controllers/project.controller";

// Services
import { NoteService } from "@/services/note.service";
import { ProjectService } from "@/services/project.service";

// Repositories
import { MockDbNoteRepository } from "@/repositories/mockdb/note.mockdb.repository";
import { MockDbProjectRepository } from "@/repositories/mockdb/project.mockdb.repository";

// =============================================================================
// App Setup
// =============================================================================
const app = new Hono<AppEnv>();

// Global middleware
app.use("*", cors());

// =============================================================================
// Note Resource
// =============================================================================
const noteRepository = new MockDbNoteRepository();
const noteService = new NoteService(noteRepository);
const noteController = new NoteController(noteService);

// =============================================================================
// Project Resource
// =============================================================================
const projectRepository = new MockDbProjectRepository();
const projectService = new ProjectService(projectRepository);
const projectController = new ProjectController(projectService);

// =============================================================================
// Routes
// =============================================================================
app.route("/notes", createNoteRoutes({ noteController }));
app.route("/projects", createProjectRoutes({ projectController }));
app.route("/", createEventsRoutes());

// =============================================================================
// Error Handler
// =============================================================================
app.onError(globalErrorHandler);

export { app };

Troubleshooting

Route Not Found (404)

•Check the path prefix matches your request
•Verify routes are mounted before the error handler
•Check for typos in route path

Type Errors

•Ensure controller is passed with correct property name
•Verify all imports use correct casing
•Check that route factory expects the correct dependency interface

Circular Dependencies

•Never import app.ts from other modules
•Keep dependency chain one-directional
•Use interface imports (import type) where possible

What NOT to Do

•Do NOT mount routes after app.onError()
•Do NOT create dependencies inside route handlers
•Do NOT use require() - use ES modules
•Do NOT hardcode repository implementations - use DI
•Do NOT forget to export the app

integrate-routes

Integrate Routes

Quick Reference

Prerequisites

Instructions

Step 1: Add Imports

Step 2: Create Dependency Chain

Step 3: Mount Routes

Step 4: Verify Order

Patterns & Rules

Dependency Chain Order

Route Path Convention

Environment-Based Repository

Grouping Dependencies

Complete Example

Troubleshooting

Route Not Found (404)

Type Errors

Circular Dependencies

What NOT to Do

See Also