# Adding A New App Route > Fully wires up a new route with required boilerplate, following this repo's conventions for subapps. Use when user wants to add a new route or app or subapp or page or screen. Use when this capability is needed. - Skill: `tomevault-io/adding-a-new-app-route` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/adding-a-new-app-route` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/adding-a-new-app-route/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/adding-a-new-app-route --- # Adding a new route Use this checklist to track your work: - [ ] Determine name & route for the new app - [ ] Determine the kind of app to create - [ ] Create a folder for the new app - [ ] Mount the new app in the global routes listing - [ ] Consider next steps ## Determine name & route for the new app If the name of the new app and the desired route have not already been specified, `AskUserQuestion` to determine that information, e.g. `MyApp` at `/my-app`. ## Determine the kind of app to create - **Static**: The simplest possible app with static-only content - **Dynamic**: A typical app that fetches data based on route params Use the answer in the next step. ## Create a folder for the new app - Choose the correct template directory based on the previous step: - **Static**: `./templates/static/Replace/` - **Dynamic**: `./templates/dynamic/Replace/` - Use that directory as the template for the new subapp - Recreate that folder structure under `/src/Apps/` - Replace all instances of `replace` and `Replace` with appropriate naming (case-sensitive) ## Mount the new app in the global routes listing Add the new route to the main route list at `src/routes.tsx`. Follow existing conventions re: alphabetization. ## Consider next steps Additional dev advice: - You may need to restart the server for the new route to take effect - Then visit http://localhost:4000/{replace} to see your new app - Examine the generated code for additional follow-ups ## Celebrate Indicate you are done with a /beep --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/artsy) — claim your Tome and manage your conversions.