Adding A New App Route
Developmentadding-a-new-app-routeAdding 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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/artsy/force/blob/HEAD/.claude/skills/adding-a-new-app-route/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/adding-a-new-app-route, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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/
- Static:
- Use that directory as the template for the new subapp
- Recreate that folder structure under
/src/Apps/<NewApp> - Replace all instances of
replaceandReplacewith 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