Directory Structure

Andurel generates a layered application with conventional locations for HTTP, data, services, and presentation code.

Application layers

 1cmd/app/          application entry point and Fx wiring
 2config/           environment-backed configuration
 3controllers/      HTTP handlers and route registration
 4router/routes/    typed route declarations
 5views/            Templ components
 6models/           entities and persistence logic
 7services/         application workflows
 8queue/            jobs and workers
 9email/            email components
10assets/           embedded compiled assets
11database/         migrations, seeds, and database setup

Generated framework code

The internal directory contains framework elements copied into the project, including routing, rendering, validation, storage contracts, and the HTTP server. The andurel upgrade command updates framework-owned files while preserving application-owned code.

Run a dry-run before upgrading:

1andurel upgrade --dry-run --diff --json

Project metadata

andurel.lock records the framework version, frontend adapter, JavaScript runtime, extensions, tools, and database conventions used by the project. Commit it to source control.