Remix Project Layout

Use this skill when defining, reviewing, or bootstrapping the on-disk layout of a Remix application.

This skill is about structure and conventions. It defines where code belongs, how route ownership maps to files on disk, and how a Remix app should be organized as it grows. When the user wants a new app scaffolded, run the bundled script instead of recreating the starter files by hand.

Root Layout

Use these root directories consistently:

• app/ for runtime application code
• db/ for database artifacts such as migrations and SQLite files
• public/ for static files served as-is
• test/ for shared test helpers, fixtures, and cross-app integration coverage
• tmp/ for runtime scratch files such as uploads, caches, or local session files