Integrate Routes

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:

1. Schema created (src/​schemas/​{entity}.schema.ts)
2. Repository implementation (src/​repositories/​mockdb/​{entity}.mockdb.repository.ts)
3. Service created (src/​services/​{entity}.service.ts)
4. Controller created (src/​controllers/​{entity}.controller.ts)
5. Routes created (src/​routes/​{entity}.router.ts)

Instructions

Step 1: Add Imports

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

// 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:

// =============================================================================
// {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:

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

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

Step 4: Verify Order

Ensure the following order in app.ts:

1. Imports
2. App creation (const app = new Hono<AppEnv>())
3. Global middleware (CORS, etc.)
4. Dependency instantiation
5. Route mounting
6. Error handler (app.onError(globalErrorHandler))
7. Export

Patterns & Rules

Dependency Chain Order

Always create dependencies in this order:

// 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:

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:

// =============================================================================
// 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

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

See Also

• create-routes - Creating the route factory
• create-controller - Creating the controller
• create-resource-service - Creating the service
• create-resource - Complete resource workflow