Is this file for Remix or React Router?
Both, in the sense that React Router v7 framework mode is where Remix development continued. If you are still on Remix v2, keep the loader and action rules and change the import rule to @remix-run packages.
React Router v7 in framework mode is the continuation of Remix. These instructions keep an agent inside the loader and action model instead of reaching for client-side fetching and global state.
# AGENTS.md
Project: react-router-app. A React Router v7 framework-mode app (the successor to Remix) with server loaders and actions.
This file is the single source of truth for every coding agent working in this repository. The tool-specific files (CLAUDE.md, GEMINI.md, .github/copilot-instructions.md and .cursor/rules/project.mdc) point here. Edit this file, not those.
## Stack
- Language: TypeScript
- Framework: React Router v7 / Remix
- Database: PostgreSQL
- Hosting: Fly.io
- Tests: Vitest
- Package manager: npm
## Commands
Run these from the repository root.
- Install dependencies: `npm install`
- Run locally: `npm run dev`
- Build: `npm run build`
- Run all tests: `npx vitest run`
- Run one test file: `npx vitest run path/to/file.test.ts`
- Lint: `npm run lint`
- Type-check: `npm run typecheck`
- Format: `npx prettier --write .`
## Project layout
- `app/routes/`: Route modules: loader, action, default component, meta
- `app/routes.ts`: The route config
- `app/components/`: Shared UI components
- `app/lib/`: Server-only helpers (files ending in .server.ts)
- `.react-router/types/`: Generated route types (do not edit)
## Code style
- Indent with 2 spaces. Never tabs.
- TypeScript runs in strict mode. Do not use `any`; use `unknown` and narrow it, or write the real type.
- Match the style and patterns of the surrounding code, even where you would personally choose differently.
- Use named exports. Do not add default exports.
- Never swallow an error. Handle it where you can act on it, or rethrow it with context about what failed.
- Commit messages follow Conventional Commits: `feat:`, `fix:`, `refactor:`, `test:`, `docs:`, `chore:`, with an imperative summary under 72 characters.
## Working rules
- Before you say a task is done, run the test, lint and type-check commands above and make sure they pass. If you could not run them, say so.
- Never write secrets, API keys, tokens or passwords into code, tests, fixtures, logs or commits. Read them from environment variables, and never commit `.env` files.
- Do not add a new dependency without asking first. Prefer the standard library and what is already installed.
- Ask before creating, editing or running database migrations, and never edit a migration that has already been applied.
- Change only what the task needs. Do not refactor, rename or reformat unrelated code.
## Product constraints
- Public pages must render their main content as HTML on the server, with a unique title, meta description and one h1.
## Project-specific notes
- Read data in the route `loader` and write data in the route `action`. Do not add client-side `useEffect` fetching for data a loader can provide.
- Use `<Form>` and `useFetcher` for mutations so they work without JavaScript; do not hand-roll `fetch` calls for form posts.
- Server-only code lives in files ending in `.server.ts` so it can never be bundled for the browser.
- Import route types from `./+types/<route>` and type loader and action arguments with them; run `npm run typecheck` after adding a route, which regenerates the types.
- Register every new route in `app/routes.ts`.
- Throw `data()` responses with the right status (404, 403) from loaders instead of returning null.
- Do not import from `@remix-run/*`; in React Router v7 everything comes from `react-router` and `@react-router/*`.
## Project phase
This project is in active development. Follow the patterns that already exist; consistency beats novelty.
# CLAUDE.md
@AGENTS.md
## Claude Code
- The shared project instructions are imported from AGENTS.md on the line above. Edit AGENTS.md, not this file, so every agent stays in sync.
- Put Claude-only preferences below this line. Personal, uncommitted notes belong in CLAUDE.local.md.
# GEMINI.md
@./AGENTS.md
## Gemini CLI
- The shared project instructions are imported from AGENTS.md on the line above. Edit AGENTS.md, not this file.
- Alternative: delete this file and set "context": { "fileName": ["AGENTS.md"] } in .gemini/settings.json so Gemini CLI reads AGENTS.md directly.
# Copilot instructions
Project: react-router-app. A React Router v7 framework-mode app (the successor to Remix) with server loaders and actions.
The full instructions are in AGENTS.md at the repository root. Read it before you change code; if anything here disagrees with it, AGENTS.md wins. The essentials are repeated below for Copilot surfaces that only read this file.
## Stack
- Language: TypeScript
- Framework: React Router v7 / Remix
- Database: PostgreSQL
- Hosting: Fly.io
- Tests: Vitest
- Package manager: npm
## Commands
- Install dependencies: `npm install`
- Run locally: `npm run dev`
- Build: `npm run build`
- Run all tests: `npx vitest run`
- Run one test file: `npx vitest run path/to/file.test.ts`
- Lint: `npm run lint`
- Type-check: `npm run typecheck`
- Format: `npx prettier --write .`
## Working rules
- Before you say a task is done, run the test, lint and type-check commands above and make sure they pass. If you could not run them, say so.
- Never write secrets, API keys, tokens or passwords into code, tests, fixtures, logs or commits. Read them from environment variables, and never commit `.env` files.
- Do not add a new dependency without asking first. Prefer the standard library and what is already installed.
- Ask before creating, editing or running database migrations, and never edit a migration that has already been applied.
- Change only what the task needs. Do not refactor, rename or reformat unrelated code.
---
description: Project instructions for every task (mirrors AGENTS.md)
globs:
alwaysApply: true
---
# Project rules
The project instructions live in @AGENTS.md at the repository root, which Cursor loads automatically. They are not repeated here, so they cost context only once. Edit AGENTS.md, not this rule.
Before you change code, check the Commands and Working rules sections of AGENTS.md, and run its test and lint commands before you say a task is done.
Put Cursor-only rules below, or add scoped rules as more .mdc files with `globs` (for example `src/components/**/*.tsx`).
These are the exact files the generator writes for this preset. Change any command or rule in the generator and download your own set.
The preset describes a a React Router v7 framework-mode app (the successor to Remix) with server loaders and actions. Its AGENTS.md is 51 non-empty lines with 8 exact commands, 5 key directories, and 7 stack-specific rules on top of the shared working rules.
npm install, npm run dev, npm run build, npx vitest run, npx vitest run path/to/file.test.ts, npm run lint, npm run typecheck, npx prettier --write ..app/routes/, app/routes.ts, app/components/, app/lib/, .react-router/types/.Agents default to the single-page-app habit of fetching inside useEffect. In framework mode that throws away server rendering, creates loading spinners the framework would have avoided, and duplicates data logic. Telling the agent where reads and writes belong is the single most effective rule for this stack.
Much of the training data is Remix v2 with @remix-run/* imports. React Router v7 moved those APIs into react-router. Without the rule, agents mix both packages and produce code that will not build.
A helper that reads an API key is harmless in a loader and a leak in a component. The .server.ts suffix makes the build fail if a browser bundle imports it, which turns a silent leak into a loud error.
Route types are generated. When an agent adds a route and sees type errors, the fix is to regenerate, not to cast to any.
loader and write data in the route action. Do not add client-side useEffect fetching for data a loader can provide.<Form> and useFetcher for mutations so they work without JavaScript; do not hand-roll fetch calls for form posts..server.ts so it can never be bundled for the browser../+types/<route> and type loader and action arguments with them; run npm run typecheck after adding a route, which regenerates the types.app/routes.ts.data() responses with the right status (404, 403) from loaders instead of returning null.@remix-run/*; in React Router v7 everything comes from react-router and @react-router/*.Want different commands or rules? Load this preset into the generator, change anything, and download your own set.
AGENTS.md is read directly by Codex, Cursor, Windsurf, Cline, Zed and Jules, and by GitHub Copilot's cloud agent, code review and CLI. Claude Code reads it through the generated CLAUDE.md, and Gemini CLI through GEMINI.md. See the compatibility table for details, last verified 2026-11-13.
All presets are on the stacks page.
Both, in the sense that React Router v7 framework mode is where Remix development continued. If you are still on Remix v2, keep the loader and action rules and change the import rule to @remix-run packages.
It is not banned everywhere; the rule only applies to data a loader can provide. Loaders render on the server, revalidate after actions automatically, and avoid loading states, so they are the default an agent should reach for first.
Partly. In SPA mode there is no server loader, so use the clientLoader rules instead. Edit the notes in the generator before downloading.
Yes. Copy them into any project, commercial or not, without attribution. They are a starting point: adjust the commands and rules to match your repository.
You do not have to take our word for it. Developer tools show every request a page makes, so you can watch this page work and confirm that nothing you type is sent. The check takes under a minute.
F12, or Cmd+Option+I on a Mac, and select the Network tab.Only the feedback form can add a line to that log, and it sends only the vote and comment you type into it. 2prompt has no server code at all: no API, no model and no database of your files. The production site also sends a Content-Security-Policy header that tells your browser to refuse connections to anywhere except this site, the fonts and the anonymous analytics endpoint.