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

Требования

• Node.js 20+
• npm
• Expo CLI (npx expo)
• EAS CLI (npx eas)
• iOS Simulator или физическое устройство с Expo Go / dev client

Установка

# Клонировать репозиторий
git clone https://github.com/happ-ai/saas-mobile.git
cd saas-mobile

# Установить зависимости
npm install --legacy-peer-deps

Peer dependency конфликты

Используй --legacy-peer-deps при конфликтах React 19.1 vs 19.2.

Переменные окружения

Создай .env в корне проекта:

EXPO_PUBLIC_API_URL=https://api.dev.happ.tools
EXPO_PUBLIC_WS_URL=wss://api.dev.happ.tools
EXPO_PUBLIC_SENTRY_DSN=...

Для локальной разработки с saas-api:

EXPO_PUBLIC_API_URL=http://localhost:3000
EXPO_PUBLIC_WS_URL=ws://localhost:3000

Запуск

# Запуск Expo dev сервера
npx expo start

# С очисткой кэша
npx expo start --clear

# С debug-режимом
EXPO_PUBLIC_DEBUG=1 expo start

Сборка

Development

# iOS dev build
eas build --profile development --platform ios

# Android dev build
eas build --profile development --platform android

# Обе платформы
eas build --profile development

Production

# iOS production build
eas build --profile production --platform ios

# Android production build
eas build --profile production --platform android

# Отправка в App Store / Play Store
eas submit --platform ios
eas submit --platform android

Тестирование на устройстве

1. Собери development client: eas build --profile development
2. Установи на устройство/симулятор
3. Запусти dev сервер: npx expo start --dev-client
4. Отсканируй QR-код для подключения

Команды для проверки кода

# TypeScript проверка типов
npm run typecheck

# ESLint
npm run lint
npm run lint:fix

# Prettier
npm run format
npm run format:check

# Все проверки разом
npm run validate

Скрипты в package.json

Команда	Описание
npm start	Запуск Expo dev сервера
npm run start:debug	Запуск с EXPO_PUBLIC_DEBUG=1
npm run lint	ESLint проверка
npm run lint:fix	ESLint с автофиксом
npm run typecheck	tsc --noEmit
npm run format	Prettier форматирование
npm run validate	typecheck + lint + format:check
npm run install:dev	Установить dev build на устройство
npm run install:prod	Установить prod build на устройство