콘텐츠로 건너뛰기
supastack
문서 둘러보기
웹Next.js

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/using-the-docs.md (or send Accept: text/markdown).

이 문서 사용하는 방법

탭, 그룹, 검색, 섹션 링크로 문서에서 길을 찾고, 내장 복사 도구로 어떤 가이드든 코딩 에이전트에게 넘기세요.

이 가이드에 대해 질문하기
다음에서 열기

페이지가 구성된 방식

이 문서는 다운로드한 키트의 설명서입니다. 가이드 목록 위의 표면 선택기 — 웹, 모바일, 데스크톱 — 에는 각 표면의 가이드가 있습니다: 브라우저 앱, 폰 앱, 데스크톱 창. 웹부터 시작하세요. 모든 표면이 통신하는 서버를 다룹니다. 각 표면은 자체 5분 퀵스타트로 열립니다.

왼쪽 열은 시작하기, 프로바이더 설정 같은 이름 있는 그룹 안의 가이드를 나열합니다. 그룹 제목을 선택해 목록을 열거나 닫고, 현재 페이지는 강조된 채로 유지됩니다. 오른쪽 열, 이 페이지에서는 읽고 있는 가이드의 섹션을 나열합니다 — 하나를 선택해 바로 이동하세요. 파일이나 설정 이름처럼 안쪽 어디에든 있는 단어로 가이드를 찾으려면 왼쪽 열 상단의 검색을 사용하거나 Ctrl + K(Mac에서는 ⌘K)를 누르세요.

가이드 하단의 다음 카드 — 대부분의 페이지에서는 이전 카드도 — 는 이웃 페이지로 이동합니다. 설정 가이드는 위에 문장 — 설정을 계속하려면 읽기 — 과 함께 다음 구성 단계로의 링크를 보여주므로 프로바이더를 순서대로 연결할 수 있습니다.

복사 도구

모든 가이드 제목 아래에 두 개의 버튼이 있습니다. Markdown으로 복사는 전체 가이드를 Markdown으로 — 페이지의 .md 버전이 제공하는 것과 같은 일반 텍스트 형식으로 — 명령, 목록, 다음 가이드로의 링크를 포함해 클립보드에 넣습니다. 프롬프트 복사는 준비된 한 줄을 복사합니다: 이 페이지의 Markdown 버전 주소와 함께 읽기가 붙은 문장. AI 채팅에 붙여넣으면 모델이 직접 가이드를 가져옵니다.

그 옆의 이 가이드에 대해 묻기는 같은 지시가 이미 채워진 상태로 ChatGPT를 새 탭에서 엽니다. Open in 메뉴는 같은 ChatGPT 바로 가기와 Markdown을 제공하며, Markdown은 브라우저에서 일반 텍스트 버전을 엽니다 — 같은 페이지 주소 끝에 .md가 붙은 것입니다.

모든 명령 블록은 위쪽 모서리에 작은 복사 버튼을 가지고 있습니다. 그 블록 안의 명령만 복사하고 주변 설명은 복사하지 않으므로 터미널에 바로 붙여넣을 수 있습니다. 각 버튼은 작동하면 잠시 복사됨을 표시합니다.

가이드를 코딩 에이전트에게 넘기기

코딩 에이전트 — 프로젝트를 읽고 편집할 수 있는 AI 어시스턴트, 예를 들어 Claude Code, Cursor, Codex — 는 사용자와 같은 지시를 읽을 때 더 잘 작동합니다. 가장 간단한 전달 방법은 프롬프트 복사입니다: 복사한 한 줄을 에이전트 채팅에 붙여넣으면 스스로 가이드의 Markdown 버전을 읽습니다. 전체 텍스트를 인라인으로 원할 때 — 예를 들어 에이전트가 가이드를 파일과 비교하게 하거나, 웹 접근이 없는 채팅에서도 보이게 하려면 — Markdown으로 복사를 고르세요.

.md로 끝나는 페이지 주소를 거의 모든 AI 채팅에 붙여넣을 수도 있습니다. 페이지 장식 없이 같은 Markdown을 반환합니다. 키트는 이 워크플로를 위해 작성되었습니다 — 저장소 안의 AGENTS.md와 prompts/ 폴더가 에이전트에게 규칙과 준비된 작업을 제공합니다.

저장소 안의 같은 콘텐츠

모든 답에 이 웹사이트가 필요한 것은 아닙니다 — 상당 부분이 다운로드한 코드 안에 들어 있습니다. 웹 저장소와 All Platforms 모노레포에서 docs/ 폴더는 더 긴 Markdown 레퍼런스 — agent-setup.md(무인 설정 런북)와 upgrading.md(이 그룹의 업데이트 워크스루 상세 버전) 같은 — 를 담고, prompts/ 폴더는 바로 붙여넣는 지시를 담고 있습니다. 독립 모바일·데스크톱 체크아웃에는 더 작은 선별된 세트가 들어 있습니다. 어느 쪽이든 저장소 루트의 llms.txt 파일은 지도입니다: 에이전트가 먼저 읽어야 할 파일과 따라야 할 규칙을 나열합니다.

실행 중인 앱도 같은 아이디어를 스스로 제공합니다: 만드는 제품을 위한 자체 /docs 가이드와, 앱의 라이브 인덱스를 에이전트에게 넘기는 /llms.txt 라우트가 있습니다.

페이지뿐 아니라 섹션에 링크하기

가이드 페이지의 모든 섹션 제목은 앵커 — 페이지 안의 링크 가능한 위치 — 이기도 합니다. 이 페이지에서 열에서 섹션을 선택하거나 제목 자체를 선택하면 브라우저 주소 표시줄에 #section-name 같은 끝이 붙습니다. 그 전체 주소는 페이지가 이미 그 섹션으로 스크롤된 상태로 열립니다.

특정 단계 하나를 가리킬 때 앵커가 붙은 주소를 팀원에게 공유하거나, 같은 이유로 에이전트 프롬프트에 붙여넣으세요. 이 그룹에는 두 개의 동반 페이지가 있습니다: 아래 용어집과, 키트 자체가 개선될 때를 위한 업데이트 워크스루.

자주 묻는 질문

질문 14개

supastack이란 무엇인가요?

supastack은 AI SaaS 제품을 구축하기 위한 모듈식 기반입니다. 공통 인프라를 모아두어 제품 고유의 기능에 집중할 수 있습니다.

웹과 모바일을 지원하나요?

네. supastack에는 웹과 모바일 경험의 출발점으로 Next.js 앱과 Expo 앱이 포함되어 있습니다.

어떤 인증이 포함되어 있나요?

Better Auth가 이메일/비밀번호, OTP, 소셜 로그인을 커버합니다. 개인 워크스페이스는 계정과 함께 프로비저닝되어 첫날부터 레코드가 경계 안에 유지됩니다.

AI는 어떻게 지원되나요?

supastack에는 구성 가능한 멀티 프로바이더 AI, 사용량 추적, 예산, 암호화된 자체 키(BYOK) 지원이 포함되어 있습니다.

구독은 어떻게 관리되나요?

이 키트 위에 구축된 제품에서는 Stripe 결제, 구독, 권한이 유료 액세스의 기반을 형성합니다. 프로바이더 시크릿은 서버 측에 유지됩니다.

제품 고유 코드는 어디에 두나요?

제품 고유 기능은 별도의 코드베이스에 두고, 제품이 supastack 기본 모듈을 구성하고 통합합니다.

supastack 가격은 어떻게 되나요?

키트는 평생 업데이트가 포함된 일회성 구매입니다: 단일 프레임워크 $249(기간 한정 출시 가격 — 정가 $349에서 $100 할인) 또는 모든 프레임워크(Next.js, iOS, Android) $499(기간 한정 출시 가격 — 정가 $599에서 $100 할인), 추가 개발자 시트당 $75. 키트 구독은 없습니다. 이 사이트의 체크아웃은 라이선스 키를 이메일로 전달하고 GitHub 초대로 리포지토리 액세스를 제공합니다.

워크스페이스는 내 데이터를 어떻게 경계 짓나요?

사용자 레코드는 workspaceId로 범위가 지정됩니다. 신원, 권한, AI 사용량, 결제 이벤트, 감사 항목은 개인 워크스페이스 경계 안에 유지됩니다.

백그라운드 작업은 어떻게 작동하나요?

Trigger.dev가 명시적인 작업 런타임입니다. JobRunner 계약은 enqueue, status, cancel만 약속하며 — 워크플로 의미는 Trigger.dev 고유이고 명시적입니다.

이메일과 아웃리치는 어떻게 다른가요?

트랜잭션 이메일은 작업 완료 알림 같은 제품 워크플로를 커버합니다. 콜드 아웃리치와 캠페인은 제품 자체에 속하며 이 키트의 이메일 모듈 밖입니다.

모바일 구매는 어떻게 작동하나요?

모바일은 RevenueCat 네이티브 구매와 복원을 지원하며 서버에서 접근 권한을 검증합니다. 출시 전에 스토어 계정을 설정하고 기기 테스트를 완료하세요. 웹 결제는 별도로 관리합니다.

AI 프로바이더 키는 어디에 있나요?

BYOK 자격 증명은 암호화되어 서버 측에 유지됩니다. 키는 로그에서 삭제되며, 사용량과 예산은 워크스페이스 수준에서 확인할 수 있습니다.

체크아웃에서 어떤 결제 수단을 지원하나요?

Stripe 호스팅 체크아웃은 카드를 받으며, Stripe 계정에서 지갑을 활성화하면 Alipay와 WeChat Pay도 제공할 수 있습니다 — 중국 구매자에게 유용합니다. 지갑 승인은 비동기로 확정되므로 결제가 완료되는 즉시 라이선스 페이지가 갱신됩니다.

환불을 받을 수 있나요?

저장소 접근 권한을 얻은 후에는 supastack이 영구적으로 귀하의 소유가 되므로 환불이 불가능합니다. 하지만 안심하세요. 평생 업데이트가 포함된 전체 소스 코드를 받아 자신이나 고객을 위한 제품을 무제한으로 구축하고 출시할 수 있습니다. 단, 코드를 재판매하거나 저장소를 스타터 키트 또는 템플릿으로 재배포할 수는 없습니다.

KO
테마