문제 해결과 자주 묻는 질문

다른 무엇을 하기 전에 화면에 무엇이 보이는지 먼저 확인하세요.

• Could not compile this project라고 적힌 빨간 카드가 보여요. 앱에 실행을 막는 오류가 있어요. 그 아래의 줄이 어떤 오류인지 알려 줘요. 그 줄을 채팅에 복사하거나 보이는 내용을 Setherion에게 말하면, 다른 변경과 마찬가지로 고쳐져요.
• Preview hit a runtime error라고 적힌 바가 보여요. 앱이 시작된 뒤 다운됐어요. 바에 있는 Fix with AI가 요청을 대신 써 줘요. 다른 변경과 마찬가지로 크레딧이 들어요.
• 아무것도 보이지 않아요. 미리보기 위 상자의 왼쪽에 있는 Reload preview 화살표를 누르세요. 미리보기를 참고하세요.

앱은 보여 주기 전에 화면에 드러나지 않게 열어서 확인하고, 다운되는 앱은 먼저 고치기 때문에 처음부터 빈 화면이 나오는 일은 드물어요. 다음 질문을 참고하세요.

모든 빌드와 모든 변경은 보여 주기 전에 화면에 드러나지 않게 열어서 확인해요. 그동안 상태 줄에 Testing the app이라고 표시돼요. 앱이 다운되면 되돌려 보내서 최대 세 번까지 고치고 다시 테스트하는데, 이 비용은 들지 않아요. 새 버전이 통과할 때까지 화면에 보이는 것은 그대로예요.

변경한 뒤에도 앱을 빌드할 수 없으면 비용이 청구되지 않아요. 크레딧이 돌아와요. 채팅에서 어떤 일이 있었는지 말하거나, 바가 나타나면 Fix with AI를 누르세요.

에디터의 빈 화면에 That build stopped partway라는 카드가 보이면, 실행이 끝나기 전에 멈췄다는 뜻이에요. 같은 요청을 다시 하세요. Build, Chat, Plan을 참고하세요.

빌드와 변경이 끝날 때마다 앱을 휴대폰 너비로 측정해요. 튀어나온 부분이 있으면 바에 Wider than a phone screen이라고 표시되고 Fix with AI도 나와요. 직접 보려면 미리보기 위의 크기 메뉴를 열고 Mobile을 선택하세요. 미리보기를 참고하세요.

빌드나 변경이 실행되는 동안 입력 상자의 전송 버튼이 네모로 바뀌어요. 그것을 누르면 멈춰요. 실행은 다음 단계에서 끝나고, 앱에는 아무것도 쓰이지 않으며, 크레딧은 돌아와요.

페이지에서 기다릴 필요는 없어요. 새로고침하거나, 탭을 닫거나, 휴대폰 화면을 잠가도 실행은 계속되어 앱에 반영돼요. Building your app 또는 Working on your change라는 작은 카드에 자체 Stop 버튼이 있고, 끝나면 알려 줄 수도 있어요.

앱의 큰 부분을 삭제하는 수정은 반영되기 전에 거부돼요. 약 40% 이상 줄어드는 파일은 원래대로 복원되고, 앱 전체에서 그만큼을 없애는 수정도 마찬가지예요. 예외는 무언가를 없애 달라고 요청한 경우뿐이에요. 변경 단계에는 Edit would have deleted page content, original preserved 같은 경고가 표시돼요. 더 정확하게 다시 요청하세요. 예를 들어 “상단 바의 색상만 바꿔 주세요”처럼요.

그래도 무언가 사라졌다면 이렇게 해 보세요.

• 채팅의 변경 아래에 있는 Undo this change는 그 변경을 되돌려요.
• 미리보기 위의 Undo와 Redo는 이번 세션의 변경을 차례로 넘나들어요.
• History에는 모든 버전이 그 버전이 한 일을 이름으로 해서 보관돼요. Restore this version을 누르면 한 버전으로 돌아가고, 돌아가기 전의 위치는 History에 남아서 다시 앞으로 갈 수 있어요.

기록을 참고하세요.

Setherion이 변경이 반영되었는지 확인할 수 없으면 메시지 아래의 체크 표시가 주황색으로 바뀌고, 메시지에는 쾌활한 한마디 대신 실제로 일어난 일이 적혀요. 정확한 위치를 지정해서 다시 요청하세요. “헤더에서 Book 버튼을 파란색으로 바꿔 주세요”처럼요. 한 번에 하나씩 바꾸는 것이 가장 잘 돼요. 좋은 프롬프트 작성법을 참고하세요.

앱을 넘겨 주기 전에 Setherion은 앱이 쓰는 사진을 확인하고, 존재하지 않는 사진은 존재하는 사진으로 바꿔요. 미리보기에서 깨진 이미지는 미리보기 오른쪽 위의 issues 표시에 Fix with AI와 함께 나타나요.

이미지를 직접 바꾸려면 미리보기 위의 Edit 버튼을 켜고, 이미지를 클릭한 다음 Image를 선택하세요. 앱이 사용하는 모든 이미지를 보려면 Code를 열고 Images 폴더를 여세요. 새 이미지가 필요하면 채팅에서 요청하거나, + 메뉴의 Media AI로 AI가 만들게 하세요. 미리보기와 미디어와 디자인 도구를 참고하세요.

앱은 요청을 쓴 언어로 말하고, 이후의 변경에서는 앱이 이미 쓰고 있는 언어를 유지해요. 다른 언어로 말하게 하려면 그렇게 말하세요. “앱 전체를 프랑스어로 번역해 주세요”처럼요. 모든 앱에 언어를 고정하려면 규칙으로 적어 두세요. 내 언어로 쓰기와 AI 설정을 참고하세요.

• 다시 게시하기 전에는 변경이 적용되지 않아요. 에디터에서 한 수정은 Publish를 눌러야 게시된 앱에 반영돼요. History에는 아직 게시되지 않은 변경이 표시돼요.
• 이전 버전이 계속 보여요. 브라우저가 이전 버전을 보관하고 있어요. Ctrl+Shift+R로 강력 새로고침하세요.
• 로그인과 데이터는 실제 것이에요. 게시된 앱은 실제 계정과 실제 데이터를 쓰기 때문에 미리보기에서 본 샘플 데이터는 없을 수 있어요.
• 게임의 광고와 구매는 미리보기에서는 모의로 동작하고, 웹사이트에서는 숨겨져요. 휴대폰 앱에서만 실제로 동작해요. 게임을 참고하세요.
• 비공개 앱은 사람들에게 먼저 워크스페이스에 로그인하라고 요청해요. 웹에 게시하기를 참고하세요.

Manage를 열고, Cloud, Users 순서로 여세요.

• 그 사람이 목록에 있어요. 로그인 자체는 성공했으니 고쳐야 할 것은 앱의 화면이에요. 로그인한 뒤에 어떤 일이 생기는지 채팅에 알려 주세요.
• 새로 가입할 수 있는 사람이 없어요. Sign-in settings를 확인하세요. 제공하는 방식에 맞게 Allow new signups, Email and password, Google sign-in이 켜져 있어야 해요. 변경은 게시된 앱에 바로 적용돼요.
• 확인 이메일이 오지 않아요. Require email confirmation이 켜져 있으면 새 계정은 받은 편지함의 링크를 열어야 해요. 다음 질문을 참고하세요.
• Google 버튼이 반응하지 않아요. 팝업으로 열리므로 브라우저에서 팝업을 허용해야 해요. 따로 설정할 것은 없고, 게시된 사이트와 미리보기에서 동작해요. 스토어에서 받은 앱의 휴대폰 버전 안에서는 동작하지 않고, 거기서는 이메일과 비밀번호로 로그인해요.
• 앱에 로그인 기능이 아예 없어요. 이때 Users에는 This app has no login이라고 표시되고 Ask AI to add accounts가 나와요.

여기서 만든 앱에는 설정할 리디렉션 주소나 Google 키가 없어요. 내 Supabase를 쓰는 앱만 달라서, 그 경우에는 그 Supabase 프로젝트에서 Google을 켜요. Cloud 사용자를 참고하세요.

• 폼 메시지: 모든 메시지는 Manage, Cloud, Forms에 보관되므로 잃어버리는 것은 없어요. 각 메시지에 대한 이메일은 방문자가 입력한 주소가 아니라 내 Setherion 계정의 주소로 가고, Email me about each message가 켜져 있어야 해요. 스팸 폴더도 확인하세요.
• 이메일 발송이 일시 중지됐어요: 반송이 10%를 넘거나 스팸으로 신고된 것이 2%를 넘으면 앱이 보내는 이메일이 저절로 멈춰요. Manage, Cloud, Emails에 Letters are paused라고 표시되고, Resume letters를 누르면 다시 시작돼요. 보통은 지어낸 주소로 스크립트가 회원가입을 하는 것이 원인이에요.
• 하루 한도: 요금제마다 앱이 보내는 이메일 수에 한도가 있어요. Free는 하루 100통, Pro는 2,000통, Business는 10,000통이에요. 한도를 넘으면 그 시간이나 그 날이 바뀔 때까지 아무것도 나가지 않아요. Emails에 내 한도가 표시돼요.
• 방문자의 한도: 방문자 한 명은 폼 메시지를 한 시간에 10개 보낼 수 있고, 앱 하나는 하루에 300개를 받아요.
• 테스트하기: Emails의 Send me a test는 앱이 보내는 방식 그대로 이메일 한 통을 나에게 보내요.

Cloud 폼과 Cloud 이메일을 참고하세요.

• 유료 요금제인가요? Free에는 커스텀 도메인이 없어요. Pro에는 3개, Business에는 25개가 포함되고, 모든 앱을 합쳐서 세어요.
• 앱을 먼저 게시했나요? 도메인은 게시된 것을 가리켜요.
• 레코드를 설정했나요? 도메인을 구매한 곳에서 A 레코드와 CNAME을 추가하고, 연결을 막을 수 있는 AAAA 레코드는 모두 삭제하세요.
• 기다렸나요? DNS는 몇 분이 걸릴 수도 있고, 길게는 이삼일까지 걸려요. 나중에 Verify Domain을 다시 누르세요. setherion.app 주소는 그동안 계속 동작해요.
• 허용되는 이름인가요? setherion.com과 setherion.app 아래의 이름은 연결할 수 없어요.
• 워크스페이스에서는 도메인 연결을 Owner와 Admin이 할 수 있어요.

커스텀 도메인을 참고하세요.

변경이나 빌드가 크레딧에 맞지 않으면 입력 상자 위의 안내 줄이 그렇다고 알려 주고, 아무것도 바뀌지 않아요. 앱은 그대로예요. 실행에 필요한 크레딧과 내가 가진 크레딧, 그리고 크레딧이 언제 다시 채워지는지도 알려 줘요. 선택지는 이번 달이 바뀔 때까지 기다리거나, 추가 크레딧을 사거나(유료 요금제에서), 요금제를 올리는 거예요. 요금제에 모델 선택기가 있다면 더 작은 모델이 비용이 적게 들어요.

잔액은 에디터의 Publish 옆과 Settings, Plan and credits에 표시돼요. 쓰지 않은 크레딧은 한 달 동안 이월돼요.

• 다른 사람의 앱에서는 크레딧이 그 앱을 만든 사람에게서 나가요. 그 사람의 크레딧이 떨어지면 안내 줄에 앱 소유자의 크레딧이 없다고 나오고, 내 크레딧은 그대로예요.
• 게시된 앱은 멈추지 않아요. 게시된 앱은 연동 크레딧이라는 별도의 제공량을 쓰고, 한도를 넘으면 새 쓰기, 호출, 이메일만 멈춰요.

요금제와 크레딧을 참고하세요.

AI 이미지나 동영상, SEO 검토, 게임 아트 그리기, 가져오기, 더 강력한 빌드 모드의 가격은 누르기 전에 해당 버튼이나 입력 상자 아래에 표시돼요. 채팅의 각 메시지는 메뉴에서 비용이 얼마였는지 보여 줘요. 게시된 앱이 쓴 양은 Manage, Cloud, Usage에 있어요. 요금제와 크레딧을 참고하세요.

Manage, Payments 순서로 열면 내 결제 화면을 확인해서, 찾은 내용과 해결 방법을 맨 위에 알려 줘요.

• 결제 화면에서 아무에게도 결제가 청구되지 않아요. 구매자는 결제 과정을 끝낼 수 있지만 결제를 받는 것은 아무것도 없어요. Stripe를 연결하거나, 배송 시 결제나 청구서 결제를 위해 Make it an order request를 선택하세요.
• 내 페이지에서 카드 정보를 요구해요. 앱에 자체 카드 번호 입력란이 있어요. 거기서는 아무것도 결제되지 않고, 카드 번호는 앱 자체의 폼에 입력하게 해서는 절대 안 돼요. 해결 방법은 Remove the card fields예요.
• 주문이 요청으로 들어와요. 구매자가 주문을 나에게 보내고, 결제를 받는 것은 아무것도 없어요.

Stripe도 승인하기 전에 게시된 사이트를 살펴보므로 쇼핑몰을 먼저 게시하세요. 결제와 온라인 스토어를 참고하세요.

주문은 구매자가 내 페이지로 돌아올 때가 아니라 Stripe가 결제가 완료되었다고 알려 줄 때 기록돼요. 그래서 결제되지 않은 주문이 목록에 있는 일은 없어요. 결제가 빠져 있다면 Manage, Payments에서 Stripe가 연결되어 있는지, 그리고 What this app sells에 가격이 추가되어 있는지 확인하세요. 결제 화면은 거기에 있는 가격만 청구할 수 있어요. 결제를 참고하세요.

유료 요금제에서는 이렇게 해요.

• Publish 옆의 폴더 아이콘인 Download ZIP은 앱을 일반 React 프로젝트로 내려받아요.
• Publish를 열고 Export to GitHub이나 Export to GitLab을 선택하면, 실행할 수 있는 Vite와 React 저장소로 푸시돼요.
• 휴대폰 프로젝트에서는 Publish to app stores, Native 순서로 선택하면 Android Studio와 Xcode에서 빌드할 프로젝트 전체를 받을 수 있어요.

모든 요금제에서 앱의 데이터는 내 Supabase에 바로 쓸 수 있는 SQL로 내보낼 수 있고, Cloud, Database의 Export CSV는 컬렉션 전체를 다운로드해요. Cloud와 앱 스토어에 게시하기를 참고하세요.

Manage, Settings, Delete this app 순서로 여세요. 앱은 My Projects의 휴지통으로 가고, 30일 동안은 되돌릴 수 있어요. 그 뒤에는 앱과 업로드한 파일이 사라져요.

앱은 그대로 두고 웹에서만 내리려면 대신 Take offline을 쓰세요. 앱 복사본은 Manage, Overview의 Make a copy예요. 설정, 개요, 내 프로젝트를 참고하세요.

Settings, Account 순서로 열고 맨 아래의 Delete account로 가세요. 확인하려면 DELETE를 입력하세요. 계정과 그 모든 데이터가 삭제돼요. 프로젝트, 커넥터, 프로필, 업로드 파일이 모두 포함돼요. 유료 구독은 같은 순간에 해지되고, 더 이상 아무것도 청구되지 않아요. 되돌릴 수 없으므로 먼저 보관하고 싶은 것을 내보내세요. 내 계정을 참고하세요.

• 앱의 채팅: 앱 자체에 관한 일은 Setherion에게 보이는 것을 알려 주세요.
• Support 페이지는 지금 Setherion의 모든 부분이 제대로 동작하는지 보여 줘요. 가이드로 이어지고, 티켓을 열어서 My tickets에서 진행 상황을 볼 수 있어요. 유료 요금제에서는 직접 이메일 주소도 제공돼요.
• 티켓은 사람이 읽어요. 어떤 앱인지, 무엇을 했는지, 무엇을 봤는지 적어 주세요.

도움 받기와 Support 페이지를 참고하세요.