Начало работы

Это руководство поможет создать первый проект и развернуть его на платформе.

Требования

• GitHub, GitVerse или SourceCraft аккаунт
• Node.js 18+ и пакетный менеджер (bun, pnpm или npm)
• Один из поддерживаемых фреймворков

Шаг 1: Регистрация

1. Перейди на app.onreza.ru
2. Войди через GitHub, GitVerse или SourceCraft
3. При первом входе автоматически создаётся персональный workspace

Шаг 2: Установка CLI

Quick Install

curl -fsSL https://raw.githubusercontent.com/ONREZA/nrz-cli/main/install.sh | bash

npm/bun

npm i -g @onreza/nrz
# или
bun i -g @onreza/nrz

Проверь установку:

nrz --version

Шаг 3: Аутентификация

nrz login

Команда откроет браузер, где нужно подтвердить вход. После подтверждения токен сохранится автоматически.

Совет

Для CI/CD используй переменную окружения NRZ_TOKEN или флаг --token вместо nrz login.

Шаг 4: Деплой

nrz deploy

nrz-cli автоматически определяет фреймворк, собирает проект и загружает артефакты на платформу. Дополнительных адаптеров или пресетов устанавливать не нужно.

Совет

Можно указать флаги явно: nrz deploy --env production или задеплоить конкретную ветку nrz deploy --branch main.

Шаг 5: Просмотр результата

После успешного деплоя CLI выведет URL:

Deployment complete!

Production:    https://my-project-workspace.onreza.app
Unique:        https://my-project-abc123-workspace.onreza.app

Открой URL в браузере — твоё приложение уже в сети!

Локальная разработка с эмулятором

nrz dev запускает dev-сервер с эмуляцией платформенных API:

nrz dev

Эмулятор предоставляет KV Store, Request Context и Environment Variables — те же API, что и в production. Для типизированного доступа установите Runtime SDK:

npm install @onreza/runtime
# или: pnpm add / yarn add / bun add

import { kv } from '@onreza/runtime/kv';
import { env } from '@onreza/runtime/env';
import { getContext } from '@onreza/runtime/context';

Что дальше?

Git интеграция Настрой автодеплой при пуше

Environment Variables Добавь секреты и конфигурацию

Custom Domain Подключи свой домен

KV Store Кэш, сессии, rate limiting

Troubleshooting

”Command not found: nrz”

Убедись что глобальные пакеты установлены в PATH:

# Проверь путь
which nrz

# Если не найден, добавь в .zshrc или .bashrc
export PATH="$HOME/.bun/bin:$PATH"

“Build failed”

1. Проверь что используешь поддерживаемый фреймворк (Next.js, Astro, Nuxt, SvelteKit, Remix)
2. Убедись что в проекте есть корректный package.json с командой build
3. Посмотри логи: nrz logs --deployment <id>