NimbleFlowNimbleFlowШустрый поток
Обратно на сайтПолучить

Быстрый старт

Добро пожаловать в NimbleFlow.

Краткий обзор шаблона. Следуйте шагам, чтобы поднять приложение локально.

После настройки откройте гайды по OAuth, оплате, AI и деплою — и запускайте продукт быстро.

Запуск локального сервера

  1. В терминале выполните команды по порядку:
git clone https://github.com/nacosof/NimbleFlow.git
cd NimbleFlow
pnpm install
cp .env.example .env

NimbleFlow рассчитан на Node.js 20+ и pnpm 10. Проверьте версию: node -v.

  1. Заполните .env — все переменные и подсказки «где взять» есть в .env.example:
  • база данных: DB_PROVIDER (postgres | mysql | supabase | mongodb) + DATABASE_URL или MONGODB_URI
  • файлы: опционально S3_BUCKET + S3_ACCESS_KEY_ID / S3_SECRET_ACCESS_KEY
  • auth: AUTH_SECRET, AUTH_YANDEX_* / AUTH_VK_*
  • оплата: PAYMENT_PROVIDER + ключи ЮKassa или Robokassa; чеки 54-ФЗ — RECEIPT_ENABLED, RECEIPT_SNO, RECEIPT_VAT
  • нейросеть: AI_PROVIDER, AI_API_KEY (опционально AI_MODEL)
  • почта / SMS: EMAIL_PROVIDER, SMS_PROVIDER
  • аналитика: NEXT_PUBLIC_YANDEX_METRIKA_ID
  1. Поднимите схему и dev-сервер:
pnpm db:push   # SQL (postgres | mysql | supabase). Для mongodb — не нужно
pnpm dev
  1. Откройте http://localhost:3000 — готово.

Структура проекта

  • /src/app — страницы (App Router)
  • /src/app/api — API-роуты
  • /src/components — UI и секции
  • /src/lib — auth, платежи, AI, email, SMS, S3, supabase, mongodb…
  • /src/db — store + Drizzle (postgres | mysql | supabase) или MongoDB
  • /src/config — site, plans, env, legal
  • /docs — гайды по настройке

Dev Login

Удобно при разработке кабинета без живой БД и OAuth:

  1. В .env поставьте AUTH_DEV_LOGIN=true
  2. Запустите pnpm dev
  3. Откройте /login → «Войти как Dev (локально)»

Кнопка только при AUTH_DEV_LOGIN=true и вне production. Оплата и OTP в этом режиме не работают. AI-чат работает, если задан AI_API_KEY.

Что дальше

  1. Карта модулей — база, Supabase, MongoDB, S3
  2. Auth: Яндекс OAuth и/или VK ID
  3. Оплата: ЮKassa или Robokassa
  4. AI-чат
  5. Яндекс Метрика
  6. Деплой
Обзор гайдов →