# Adding A New App Route

> Adding A New App Route is an Agent Skill for development published in the artsy/force repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

- Skill name: `adding-a-new-app-route`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/artsy/force/blob/HEAD/.claude/skills/adding-a-new-app-route/SKILL.md
- Repository: artsy/force (635 GitHub stars when collected)

## SKILL.md

# 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/<NewApp>`
- 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

---

Source: https://www.openparable.com/skill/development/adding-a-new-app-route (OpenParable). Cite the canonical URL above.
