Remix Cursor Rules Template

---
description: "Routing & Data Loading"
alwaysApply: false
---
- Use file-based routing with flat route convention.
- Use loader() for server-side data fetching on every route.
- Use    spaces for indentation.
- Use camelCase for function and variable names.
- Return typed JSON responses from loaders.
- Use useLoaderData() for type-safe access to loader data.

---
description: "Forms & Actions"
alwaysApply: false
---
- Use <Form> component for all mutations (no client-side fetch).
- Use action() functions for form submissions.
- Use useActionData() for validation errors and feedback.
- Use useNavigation() to show loading states during form submissions.
- Implement progressive enhancement with vanilla HTML forms.
- Use useFetcher() for non-navigation mutations.

---
description: "Error & Boundary Handling"
alwaysApply: false
---
- Use ErrorBoundary exports for route-level error UI.
- Catch errors in loaders and actions with structured error responses.
- Use useRouteError() to access error details in error boundaries.
- Provide user-friendly error messages — never expose stack traces.
- Use isRouteErrorResponse() to distinguish route errors from unexpected errors.
- Log errors server-side with proper context.