기술

먼저 빌드의 상태 페이지를 여세요 — 각 단계마다 "로그" 버튼이 있어 어디서 실패했는지 정확히 확인할 수 있습니다. 대부분 실패는 세 가지 부류입니다: 일시적인 인프라 문제(Retry 클릭), AI가 직접 고칠 수 있는 코드 오류("빌드가 실패했어요. 에러는: …"라고 채팅을 시작하고 관련 로그 줄을 붙여넣기), 연결된 외부 서비스 문제(Stripe, GitHub, 도메인 공급자 등). 어디에도 해당하지 않으면 프로젝트 ID와 함께 지원팀에 문의해 주세요 — 파이프라인을 수동으로 재실행해 드립니다.

세 가지 흔한 원인이 있습니다. (1) DNS가 아직 완전히 전파되지 않은 경우 — 5~15분 기다린 뒤 하드 새로고침. (2) 브라우저가 이전 자산을 캐싱한 경우 — 시크릿 창에서 열기. (3) 첫 빌드의 결과가 문법적으로는 올바르지만 논리적으로 잘못된 경우 — 채팅으로 "홈을 열면 빈 화면이 나와요"라고 보내면 다음 리파인먼트에서 AI가 수정합니다. 브라우저 콘솔(F12 → Console)에 실제 오류가 표시되는 경우가 많습니다.

빌드는 공용 큐에서 실행됩니다. Free와 Starter 플랜은 표준 우선순위를 가지며 피크 시간대에 몇 분 대기할 수 있습니다. Pro와 Business는 우선 슬롯을 받아 거의 대기하지 않습니다. 빌드가 10분 이상 큐에 있다면 비정상입니다 — 페이지를 새로고침하세요(상태는 websocket으로 갱신되며 가끔 연결이 끊깁니다). 그래도 시작되지 않으면 프로젝트 ID와 함께 지원팀에 문의해 주세요.

가능합니다. 프로젝트를 열고 점 세 개 메뉴에서 "재배포"를 선택하세요. 코드는 그대로 유지되지만 새로 설정한 환경 변수가 반영되고, 만료된 빌드 아티팩트가 재생성되며, 런타임 보안 패치 같은 플랫폼 측 개선 사항이 적용됩니다. 변경 없는 재배포는 1크레딧이며 1분 이내에 끝납니다.

AWS에서 호스팅되며 기본 리전은 us-east-1입니다. 정적 자산은 CloudFront의 글로벌 엣지 네트워크에서 제공되므로 원본이 어디 있든 방문자는 가까운 PoP에 접속합니다. 서버 사이드 렌더링은 AWS Lambda에서 실행되고, 프로젝트 데이터베이스는 Amazon RDS Postgres, 업로드된 파일은 S3에 저장됩니다. EU 데이터 레지던시는 로드맵에 있지만 아직 제공되지 않습니다 — 꼭 필요한 요건이라면 지원팀에 알려 주세요.

가능합니다 — 프로젝트의 코드는 사용자 이름으로 생성된 GitHub 저장소에 있습니다. 프로젝트 설정 → 저장소에서 URL을 확인하고 사용자 계정에 쓰기 권한을 부여하세요. 일반 저장소처럼 클론, 포크, 다른 GitHub 조직으로 이동이 모두 가능합니다. 데이터베이스도 마찬가지로 설정 → 데이터베이스 → 내보내기에서 Postgres 연결 문자열을 제공합니다. 코드와 데이터의 소유권은 사용자에게 있으며, FloopFloop은 그 위에 얹힌 배포 + AI 레이어입니다.

Pro 이상 플랜에서 가능합니다. 프로젝트를 열고 설정 → 도메인에서 "도메인 추가"를 클릭하고 도메인(루트 또는 서브도메인)을 입력하세요. FloopFloop이 등록 기관에 추가할 두 개의 DNS 레코드를 표시합니다 — CNAME(apex 도메인의 경우 A/ALIAS)과 검증용 TXT 레코드. 두 가지 모두 감지되면 SSL이 자동 발급되고 보통 5~30분 안에 도메인이 가동됩니다. Free와 Starter는 사용자 도메인을 지원하지 않으므로 업그레이드가 필요합니다.

대부분의 문제는 DNS 쪽입니다. CNAME(또는 A/ALIAS) 레코드가 존재하고, FloopFloop이 표시한 값을 가리키며, 검증을 막는 프록시 뒤에 있지 않은지 확인하세요(Cloudflare의 "오렌지 클라우드"는 검증이 끝날 때까지 꺼두었다가 이후 다시 켤 수 있습니다). 터미널에서 `dig your-domain.com +short`를 실행하면 외부에서 보이는 값을 확인할 수 있습니다. 검증은 보통 15분 이내에 끝나며, 한 시간이 지나도 "Pending"이면 도메인을 알려 주시고 지원팀에 문의해 주세요.

모든 secret은 AWS Secrets Manager에서 AES-256으로 저장 시 암호화되며, 프로젝트 런타임 내부에서 요청 시점에만 복호화됩니다 — 디스크나 빌드 로그에 기록되지 않습니다. 저장된 secret 값은 write-only로, 업데이트나 삭제는 가능하지만 대시보드에서 다시 읽을 수는 없습니다. FloopFloop 직원은 평문 값에 접근할 수 없으며, 키 이름과 감사 메타데이터만 봅니다.

가능합니다. 설정 → Secret으로 들어가 항목을 찾고 "교체"를 클릭한 뒤 새 값을 붙여넣으세요. 약 30초 안에 실행 중인 런타임이 새 값을 읽기 시작합니다(secret을 핫리로드하며 함수는 재시작하지 않습니다). Secret이 빌드 타임 설정의 일부라면(드뭅니다), 재배포를 요청하는 배너가 표시됩니다 — 약 1분, 1크레딧이 듭니다.

채팅에서 AI에게 "매일 오전 9시에 실행되어 새 가입자 요약을 이메일로 보내주는 cron 작업을 추가해줘"라고 말하세요. AI가 코드에 `/api/cron/<이름>` 라우트를 생성하고 스케줄(cron 표현식 또는 간격)을 등록합니다. 재배포할 때마다 저희 스케줄러가 등록을 동기화합니다. 모든 호출은 프로젝트 스코프의 bearer 토큰과 함께 도착하므로 저희 스케줄러만 트리거할 수 있습니다. 실행 기록과 로그는 설정 → 스케줄에서 확인할 수 있습니다.

macOS와 Linux: `curl -fsSL https://floop.tech/install.sh | sh`. Windows: floop-cli 저장소의 GitHub Releases 페이지에서 최신 설치 프로그램을 받거나 `winget install FloopFloopAI.floop`를 사용하세요. 설치 후 `floop login`을 실행하면 브라우저가 열려 이 기기를 인증합니다. 그 후에는 `floop new`, `floop refine`, `floop deploy` 등 다른 명령이 추가 설정 없이 동작합니다.

CLI 토큰은 `floop login`이 로컬 설정에 기록하는 자격 증명으로, 특정 기기의 사용자(사람)를 식별합니다. 해당 노트북을 더 이상 쓰지 않을 때 /account/devices에서 폐기할 수 있습니다. API 키는 스크립트, CI, 외부 앱에서 무인 접근을 위한 것으로 /account/api-keys에서 생성하고 필요하면 프로젝트로 범위를 좁히고 언제든 교체할 수 있습니다. 둘 다 같은 `/api/v1/*` 영역을 호출하지만, 자동화에는 API 키만 사용해야 합니다.

있습니다 — 8개의 공식 SDK(Node, Python, Go, Rust, Ruby, PHP, Swift, Kotlin)는 모두 같은 `/api/v1/*`를 래핑하고 동일한 메서드 이름을 제공합니다. 엔드포인트를 추가하면 같은 릴리스에서 모든 SDK에 동일하게 반영됩니다. MCP 서버(`@floopfloop/mcp`)는 Node SDK를 LLM 에이전트에 재노출하며 새 메서드를 자동으로 가져옵니다. 차이를 발견하면 버그이니 해당 SDK 저장소에 이슈를 열어 주세요.