For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ko/docs/web.md (or send Accept: text/markdown).

소개

supastack이 무엇인지, 무엇을 받는지, 실행 중인 앱까지의 경로.

이 가이드에 대해 질문하기

여기서 시작하세요: 당신이 받은 것

키트는 사용자 정의할 수 있는 시작 앱입니다. 웹은 브라우저 인터페이스에 서버 API를 더한 것입니다. 모바일은 전화 인터페이스입니다. 데스크톱은 웹 앱을 표시하는 기본 창입니다. API는 클라이언트가 로그인하거나 데이터를 읽기 위해 호출하는 서버 주소입니다. 공유 패키지는 이러한 앱에서 사용되는 재사용 가능한 부분입니다.

아래의 웹 로컬 튜토리얼부터 시작해 보세요. 라이브러리를 다운로드하고, 서버를 시작하고, 가짜 AI task를 실행하는 방법을 정확하게 알려줍니다. 그런 다음 저장된 계정에 대한 데이터베이스를 추가하고, 제품에 필요한 공급자만 선택하고, 브랜드를 맞춤화하고 호스팅을 준비하세요. 나중에 기술적인 설명을 읽을 수 있습니다. 첫 번째 데모를 열기 위한 전제 조건은 아닙니다.

공유 기반에서 구축

supastack은 웹, 모바일, 데스크톱에서 AI SaaS를 위한 모듈형 기반입니다. Next.js는 웹 UI와 API를 전달하고, Expo는 기본 참조 흐름을 제공하며, Tauri 데스크톱 셸은 동일한 웹 앱을 로드합니다. 공유 패키지는 ID, 작업 공간, 청구, AI, 작업, 이메일, 스토리지 및 관찰 가능성을 처리합니다.

모듈이 어떻게 결합되는지 이해하려면 로컬 참조 흐름부터 시작하세요. 해당 흐름이 사용자 환경에서 작동한 후에만 프로덕션 공급자를 구성하십시오.

주변에서 길을 찾아보세요

애플리케이션은 공유 패키지를 구성합니다. 제품별 기능은 재사용 가능한 코어가 아닌 소비 제품 코드베이스에 속합니다.

apps/
  web/       Next.js interface and API routes
  mobile/    Expo application
packages/
  auth/      Identity and sessions
  db/        Schema and workspace persistence
  billing/   Billing and entitlements
  ai/        Providers, routing, and usage
  jobs/      Background job contract
  email/     Transactional delivery

출발점을 선택하세요

5분 로컬 설정부터 시작하세요. 그런 다음 각 가이드 하단에 있는 설정 계속 링크를 따르세요. 배포를 준비하기 전에 데이터베이스, 인증, 요금제, 공급자를 구성합니다. 전체 문서 색인으로 모든 기능, 공급자, 컴포넌트, 참조를 찾으세요.

로컬 골든 패스는 프로젝트의 개발 환경에서 통과했습니다. 시간을 측정한 클린 클론 설정, 실제 공급자 스모크, 배포, 물리적 장치 승인은 별도의 검증 단계로 남아 있습니다.

supastack에 오신 것을 환영합니다

supastack은 AI SaaS 제품을 위한 모듈식 키트입니다: Next.js 웹 앱, Expo 모바일 앱, Tauri 데스크톱 셸이 모두 인증, 결제, AI, 작업, 이메일, 스토리지, 옵저버빌리티를 위한 공유 TypeScript 패키지 위에 구축되어 있습니다.

구매 후에는 키트 리포지토리 — 웹, 모바일, 데스크톱(All Platforms 번들은 전체 모노레포를 제공합니다) — 에 대한 GitHub 초대를 받습니다. 출시할 표면을 클론해 당신의 것으로 만드세요.

이 문서는 레퍼런스 모음이 아니라 단계별 경로입니다: 먼저 앱을 로컬에서 실행한 다음 프로바이더 설정 페이지를 순서대로 따라가세요. 각 페이지는 끝에서 다음 페이지를 가리킵니다.

로컬 서버 시작

Node.js 22 이상이 필요합니다. 리포지토리는 패키지 매니저를 고정합니다(packageManager: [email protected]) — Corepack을 통해 pnpm을 실행하면 전역 설치가 필요 없습니다.

1. 환경 파일을 복사해 로컬 구성을 만드세요.

2. 워크스페이스 의존성을 설치하세요.

3. 선택적으로 로컬 Postgres 컨테이너를 시작해 실제 영속성을 확보하세요 — 기본값은 그것 없이도 실행됩니다.

4. 개발 서버를 시작하고 http://localhost:3000을 여세요.

cp .env.example .env
corepack pnpm install
docker compose up -d postgres   # optional local database
corepack pnpm dev

# → http://localhost:3000

.env 파일

환경 설정은 키트에서 사용하는 로컬 또는 호스팅 서비스를 선택합니다. 마이그레이션의 경우 .env.example을 루트 .env에 복사하고 웹 서버의 경우 apps/web/.env.local에 복사합니다. Expo는 apps/mobile/.env.local.를 사용합니다. 루트 .env만 복사해도 모든 앱이 구성되지는 않습니다.

기본 가짜/로컬 공급자에게는 유료 API 자격 증명이 필요하지 않습니다. 이를 통해 메모리 내/대시보드 데모를 완료할 수 있습니다. /auth의 실제 로그인에는 여전히 PostgreSQL 및 마이그레이션이 필요합니다. 실제 공급자의 경우 웹 구성 파일에서 명명된 설정만 변경하고 저장한 다음 서버를 중지하고 다시 시작합니다. NEXT_PUBLIC_ 또는 EXPO_PUBLIC_ 값을 통해 비밀을 노출하지 마십시오.

경로 선택

처음이신가요? 5분 만에 출시 문서가 클론부터 기본값만으로 실행되는 앱까지 안내합니다.

폰이나 데스크톱용으로 빌드하시나요? Mobile과 Desktop 탭이 Expo와 Tauri 표면을 다룹니다. 앱이 켜지면 프로바이더 설정 그룹이 각 통합을 문서별로 안내합니다.

설정을 계속하려면 5분 만에 출시 가이드를 읽어보세요.

소개