API ВЕГА

Поднимает минимальный проект 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