Modules and Project Structure

Modules in Norscode are not only about splitting code into more files. They are about making responsibility easier to locate. Good module structure tells the reader where rules belong, where HTTP handling belongs and where storage or integration details should live.

Split by responsibility

A helpful default is to keep route handling, domain rules, infrastructure and integrations in separate places once a project outgrows a single file.

app/
domain/
infra/
integrations/

Why this helps

Responsibility-driven modules reduce accidental coupling and make both tests and reviews more focused. They also help teams work in parallel because ownership boundaries are easier to see.

Read this together with architecture and functions for the full structure story.