Что это. Фреймворк поверх React: маршруты, серверный рендер, сборка. Сам проект описывает себя так: «The React Framework».
Возраст. Репозиторий на GitHub заведён 5 октября 2016 года. Проект ведёт компания Vercel.
Размер. 142 100 звёзд, 31 900 форков на сентябрь 2026.
Правила у Next.js разложены по нескольким файлам: короткий contributing.md и каталог contributing/ с разделами core, docs, repository, turbopack. Каталога examples там сейчас нет.
Правки-мелочи не приветствуются — и причина названа прямо:
Every pull request has to be reviewed by a maintainer… Reviewer attention is the scarcest resource the project has. Trivial PRs such as typo fixes, formatting, or code style changes are likely to be closed.
Каждый PR должен прочитать мейнтейнер. Внимание ревьюера — самый дефицитный ресурс проекта. Мелкие правки вроде опечаток, форматирования и стиля кода, скорее всего, закроют.
Для документации в docs/ исключение: там к таким правкам «более открыты».
Новая возможность начинается не с кода, а с обсуждения:
You do not need permission to work on an issue. For new features, open a discussion and get the proposal accepted first.
Разрешения работать над задачей не нужно. Для новых возможностей сначала откройте обсуждение и добейтесь принятия предложения.
Объяснение — в contributing/core/adding-features.md: «Any feature added to Next.js is likely to be around for a while and has to be maintained» (любая добавленная возможность останется надолго, и её придётся поддерживать).
Описание PR пишет человек, даже если код помогал писать ИИ:
…you must review and deeply understand the contributions you are making. For this reason, pull request descriptions from external contributors must be written by a human.
Вы обязаны проверить и глубоко понимать то, что присылаете. Поэтому описания PR от внешних участников должны быть написаны человеком.
Задача с сорока тремя комментариями живёт пять месяцев без ответа команды, пока её не берёт один человек; зато когда берёт — ревью идёт быстро и по существу (один вопрос, один ответ, влито через три дня). О выкате правки в канарейку приходят сказать в ту же задачу, где ждали.
Минусы под комментариями «same issue» — тоже часть нравов этой площадки.
Ветка одна — canary: «All pull requests should be opened against canary», из неё регулярно публикуется npm-тег @canary. Стабильный канал выходит по semver отдельно.
Коммиты подписываются ключом, и sign-off не считается:
Unsigned commits will be rejected by the repository rules… A
Signed-off-byline in the commit message is not enough to satisfy this requirement.
Неподписанные коммиты отклонят правила репозитория. Строки Signed-off-by в сообщении недостаточно.
Формата сообщения коммита в правилах нет — в инструкции просто git commit -m "DESCRIBE_YOUR_CHANGES_HERE".
Линтеры — три: ESLint, Prettier и alex (проверка языка в текстах). Проверка — pnpm lint, автопочинка — pnpm lint-fix, для документации — pnpm prettier-fix.
Тесты — на TypeScript, из шаблона: заготовку создаёт pnpm new-test, новые e2e-тесты идут через nextTestSetup в изолированную установку. Правило, которое многие только подразумевают:
When applying a fix, ensure the test fails without the fix.
Чиня баг, убедитесь, что без починки тест падает.
Каждой новой ошибке или предупреждению положена ссылка на описание — pnpm new-error.
Как получить права на запись, не написано; CODEOWNERS — один комментарий со ссылкой на справку GitHub.
Всё ниже — из contributing.md, contributing/repository/triaging.md и шаблона PR самого проекта.
Смотрят всё: «Repository maintainers triage every issue and PR opened in the repository».
Чеклист PR зависит от типа. Для бага: связанная задача через fixes #number, тесты, ссылка в тексте ошибки. Для возможности: принятое обсуждение, e2e-тесты, документация, телеметрия.
Багрепорты закрывает бот:
…if the reproduction is missing or insufficient, the issue is automatically closed, and a comment is added with a correct course of action.
Если воспроизведение отсутствует или недостаточно, задача закрывается автоматически, а в комментарии объясняют, что делать.
Метка please add a complete reproduction даёт 2 дня, please verify canary и please simplify reproduction — 14 дней бездействия, потом закрытие. Зато подтверждённая задача получает метку linear: … и «never become stale».
Закрытое запирается через две недели тишины; переоткрыть можно в течение 14 дней комментарием, где есть Reopen: и причина.
О CLA и DCO в собранных файлах ни слова. Документацию смотрят команды Next.js и Developer Experience; предпросмотра нет — «The underlying docs code lives in a private codebase that is synced to the Next.js public repo».
Люди, встреченные в наших разборах этого проекта. Черта называется только вместе с поступком — с датой и ссылкой. Ник — главный, имя — из профиля; нет имени в профиле — только ник.
Три захода на одну поломку за два месяца:
- 07.07.2023 — PR #52393, влит 12.07;
- 24.07.2023 — сам пришёл в чужую задачу и уменьшил ценность своей же правки: «unfortunately, #52393 only helps with testing server only code… It does not help with testing RSC»;
- 04.08.2023 — PR #53578, «another attempt», влит 16.08;
- 01.09.2023 — PR #54891, 54 файла, +393/−142, в заметках ревьюерам: «Hopefully this is the last attempt, and a successful one».
В команде Vercel. 01–04.09.2023 — ревью #54891: один вопрос по существу («значит, под Node тесты уже не запустить?»), проверка ответа своими руками («Found this transform won't apply when jest condition is true, makes sense») и вливание.
04.09.2023 — пришёл в закрытую и запертую задачу сказать, что правка в канарейке: «Please let us know if it's working for y'all 🙏 Appreciate your patience».
andremendonca — André Mendonça — 19.03.2023 открыл задачу про тесты с generateMetadata. defrex — Aron Jones — 23.03.2023 открыл соседнюю, #47448.
red2678 — 26.05.2023, четыре слова: «Three months later. ...rip»; 07.07.2023 вступился за тех, кому ставят минусы: «We are consumers of this, not the maintainers».
ctsstc — 15.06.2023, про первый тест в новом проекте: «the first test you write blows up and SWC gives you no useful message to go off of». Жалоба не на баг, а на сообщение об ошибке.
- «Пакет, который ломается нарочно» —
server-onlyв тестах Next.js: пять месяцев тишины, три захода одного человека и правка в канарейке.
Карточка собрана 02.09.2026 из открытых источников: репозиторий, документация проекта, переписка в PR и задачах. Фотографий и личных данных здесь нет и не будет. Нашли неточность или хотите, чтобы вас убрали, — напишите, поправим без вопросов.