# Remix 3 — The fully-stacked web framework

> Remix brings together a server runtime, routing, authentication, sessions, database integrations, a UI framework, asset compilation, dynamic styling, and accessible components in a cohesive stack built on Web APIs.

This is Remix 3, which has its own UI runtime; do not assume React hooks or Remix 2 route conventions. For apps on Remix 1 or 2, use the [legacy documentation](https://v2.remix.run/docs).

Create an app with the Remix CLI, replacing `my-app` with your app's directory name:

```sh
npx remix new my-app
cd my-app
npm install
```

Confirm it works with `npm run typecheck` and `npm test`. `npm run dev` starts a development server that runs until stopped, so coding agents should run it in the background.

**Working in a Remix app:**

1. Check the installed version with `npm ls remix`, then read the app's `AGENTS.md` and `.agents/skills/remix/SKILL.md`. If the app has no skill, use the [Remix agent skill](https://raw.githubusercontent.com/remix-run/remix/main/.agents/skills/remix/SKILL.md).
2. Search `node_modules/remix/INDEX.md` for the task or API and read the matching guide and package README. These match the installed version; the online docs follow the latest release.
3. Check your work with typechecks and focused tests, and run `npx remix doctor` after changing routes or configuration.

## Learn more

- [Start here](https://docs.remix.run/start-here.md): Build your first app, then learn how each part of Remix fits together.
- [Documentation](https://docs.remix.run/index.md): Index of every guide and the API reference.
- [API reference](https://docs.remix.run/api.md): Index of every Remix package and its API.
- [Remix agent skill](https://raw.githubusercontent.com/remix-run/remix/main/.agents/skills/remix/SKILL.md): Instructions for building, reviewing, and testing Remix 3 apps.
- [Source code](https://github.com/remix-run/remix): Framework source and development history.
