Поднимает минимальный проект Next.js + Convex по идее в одном предложении: создаёт проект, устанавливает зависимости и запускает локальные серверы с anonymous dev deployment. Помогает быстро получить рабочий шаблон без публикации и заранее настроенной авторизации.
Возможности
- Получает и кэширует шаблон через
quickstart-recipe@^2; есть закреплённый offline fallback. - Запускает backend и web dev server, затем показывает dev URL.
- Если scaffold не запускается или нужен только код, создаёт стандартный Convex-проект напрямую. Backend-код размещает в
convex/. - При работе с backend учитывает ограничения Convex: использует индексы и ограниченные выборки, корректные импорты и
httpAction. - Перед завершением backend-работы проверяет TypeScript и push в deployment.
Когда использовать
- Нужно быстро запустить локальный Next.js + Convex проект по краткому описанию идеи.
- Нужен минимальный шаблон без hosting, публикации и готовой авторизации.
- Scaffold недоступен, например из-за отсутствия сети или non-interactive session, либо нужны только backend-код и файлы проекта.
Примеры
Проверить TypeScript:
npx tsc --noEmit
Проверить deployment, если пользователь уже авторизован:
npx convex whoami
npx convex dev --once
Если npx convex whoami не срабатывает, запустить anonymous dev:
CONVEX_AGENT_MODE=anonymous npx convex dev --once