GitHub, .zip, Lovable에서 기존 앱 가져오기

Q: 가져오면 내 GitHub 저장소가 바뀌나요?

기본 브랜치는 바뀌지 않습니다. 푸시 권한이 있으면 변경 사항이 monstarx 브랜치에 저장되고, 없으면 저장소를 읽기만 합니다.

핵심 요약프로젝트 페이지에서 가져오기를 열고 GitHub, .zip, Lovable 중 하나를 선택하세요. MonstarX가 몇 초 안에 코드를 검사하고 그대로 실행되는지 알려 줍니다. 가져오기 및 실행을 누르면 앱이 미리보기에서 열리고, 대화, 편집 모드, 버전, QA가 모두 내 코드에서 작동합니다. 휴대폰 앱, Django, Rails처럼 MonstarX에서 실행할 수 없는 앱은 분석해서 다시 만들 수 있습니다.

개발자가 만들었거나, 다른 AI 빌더에서 내보냈거나, GitHub 저장소에 있는 앱이 이미 있나요? 그 앱을 가져오세요. MonstarX가 먼저 코드를 검사하고, 실행할 수 있는지 몇 초 안에 알려 줍니다. 그다음에는 미리보기에서 지금 모습 그대로 실행되고, MonstarX가 만든 앱처럼 대화로 계속 개선할 수 있습니다.

앱은 어떻게 가져오나요?

프로젝트 페이지의 프롬프트 입력란에서 가져오기를 열고 코드가 있는 곳을 선택하세요.

프롬프트 입력란 아래에 열린 가져오기 메뉴. GitHub, Lovable, .zip, Figma, 웹사이트, 스프레드시트, 내 에이전트가 있습니다

가져오기 → GitHub을 선택하세요.
저장소 주소(github.com/acme/shop 또는 acme/shop)를 붙여 넣고 확인을 누르세요. GitHub 계정이 연결되어 있으면 비공개 저장소를 포함한 내 저장소 목록에서 고를 수 있습니다.
검사 결과를 읽으세요. 다른 브랜치를 고르거나, 앱이 특정 폴더 안에 있다면 다른 폴더를 고르면 다시 검사합니다.
가져오기 및 실행을 누르세요.

공개 저장소는 주소만 있으면 가져올 수 있습니다. 비공개 저장소는 먼저 프로젝트의 GitHub 메뉴에서 GitHub을 연결하세요. 자세한 내용은 GitHub을 참고하세요.

shadcn-ui/taxonomy를 검사한 기존 코드 가져오기 창. 그대로 실행 · 기존 호스팅 서비스에서 게시, 파일 165개 · 코드 347 KB, 만든 도구(Next.js 13, React 18, TypeScript, Tailwind, shadcn/ui, Prisma, NextAuth, Stripe), 코드가 언급하는 키, main 브랜치, 라이선스: MIT, 그리고 대신 MonstarX에서 다시 만들기와 가져오기 및 실행 버튼이 있습니다

가져오기 → .zip을 선택하세요.
프로젝트 폴더를 압축한 .zip을 끌어다 놓거나 선택하세요. 먼저 내 컴퓨터에서 검사하며, 가져오기 전에는 아무것도 업로드되지 않습니다.
검사 결과를 읽고 가져오기 및 실행을 누르세요. 코드로 프로젝트가 먼저 만들어지고, 이미지는 하나씩 뒤따라 올라갑니다(“이미지 업로드 중… 9개 중 3개”).

zip은 브라우저에서 압축을 풀기 때문에 node_modules, 빌드 폴더, .env 파일은 내 컴퓨터 밖으로 나가지 않습니다. zip은 최대 500 MB까지 가능합니다. 프로젝트 폴더를 그대로 올리세요. 종속성과 빌드 폴더는 자동으로 제외되고, 앱 파일만 읽어서 가져옵니다.

corner-bakery.zip 검사 결과. 그대로 실행, 파일 7개 · 코드 1 KB, Vite와 React 19. 미리보기, 대화, 편집 모드, 버전, QA가 모두 지금 코드 그대로 작동하고, package.json에서 자체 패키지를 설치하며, 키 1개(VITE_SHOP_NAME)를 묻는다는 안내가 있습니다

검사 결과는 무엇을 뜻하나요?

배지	제목	의미
그대로 실행	“MonstarX에서 그대로 실행”	Vite 앱(또는 MonstarX에서 내보냈다가 돌아오는 앱)입니다. MonstarX에서 실행, 편집, 게시까지 모두 됩니다.
그대로 실행 · 기존 호스팅 서비스에서 게시	“MonstarX에서 실행 · 기존 호스팅 서비스에서 게시”	자체 서버가 있는 앱입니다. Next.js, Remix, Astro, Nuxt, SvelteKit, Create React App 등이 해당합니다. 여기서 실행하고 편집하며, 게시 → Vercel에서 게시하거나 변경 사항을 GitHub에 저장해 지금 쓰는 호스트를 계속 쓸 수 있습니다.
여기서 실행할 수 없음	“그대로 실행할 수는 없지만 MonstarX에서 다시 만들 수 있음”	휴대폰 앱이나 데스크톱 앱, 일반 HTML 사이트, Django, Rails, Laravel, Go 등으로 만든 사이트입니다. MonstarX가 분석해서 웹 앱으로 다시 만들 수 있습니다.
아직 가져올 수 없음	예: “앱이 아닌 라이브러리”, “너무 커서 가져올 수 없음”	MonstarX가 실행할 수도, 다시 만들 수도 없는 경우입니다. 이유와 함께, 무엇을 바꾸면 가능해지는지 알려 줍니다(앱이 들어 있는 폴더만 가져오라는 안내가 많습니다).

모든 검사 결과에는 앱을 만든 기술, 크기, 그리고 예시 환경 파일에 이름이 적힌 키(VITE_MAPBOX_TOKEN 같은 설정)가 표시됩니다. 키의 값은 절대 표시하지 않습니다. 가져오기를 막지 않는 경고는 주황색으로 표시됩니다. 커밋된 .env 파일(복사하지 않습니다. 그 안의 키는 백엔드 → 시크릿에 넣어야 합니다), Docker Compose로 시작하는 서비스, 자체 API 서버, Git LFS에 있는 파일, 제외되는 10 MB 초과 파일 등입니다.

가져온 다음에는 어떻게 되나요?

작업 공간이 열리면서 가져온 내용을 알려 주는 카드가 표시되고, 미리보기에서 앱이 시작됩니다(처음 시작할 때는 패키지를 설치하느라 1~2분 걸립니다).

미리보기에서 실행 중인 가져온 베이커리 앱. 대화에 가져온 앱: corner-bakery.zip 카드가 있고, 코드 파일 7개, Vite와 React 19, 앱의 키가 표시됩니다

앱의 키에는 코드가 읽는 설정이 실제로 얼마나 필요한지에 따라 정렬되어 나열됩니다. 필요(그 설정을 읽는 앱 기능이 설정 없이는 작동하지 않음), 선택 사항(코드에 대체 값이 있음), 사용되지 않음입니다. 값을 붙여 넣고 추가를 누르세요. 프로젝트의 예시 파일에 값이 있으면 그 값을 쓰는 “…” 사용 버튼을 눌러도 됩니다. 그러면 새 값으로 미리보기가 다시 시작됩니다. 값은 백엔드 → 시크릿에 암호화되어 보관됩니다.

가져온 앱: corner-bakery.zip 카드. 앱의 키에 VITE_SHOP_NAME이 선택 사항으로 표시되고, 코드에 대체 값이 있어 없어도 앱이 작동한다는 설명, 값 입력란, 추가 버튼, 예시 값을 쓰는 버튼, 그리고 값을 모르나요? 프로젝트를 만든 도구에 물어보세요 버튼이 있습니다

값을 전혀 모르겠나요? 값을 모르나요? 프로젝트를 만든 도구에 물어보세요를 누르면, 프로젝트를 만든 도구(Lovable 프로젝트라면 Lovable 대화창)에 붙여 넣을 메시지가 나옵니다. 코드는 바꾸지 말고 모든 키와 각 키를 어디서 복사하는지 알려 달라는 내용입니다.

코드에 키가 직접 적혀 있으면 카드에 키의 종류와 파일이 표시되고(값은 절대 표시하지 않음), Stripe 비밀 키나 OpenAI 키처럼 비밀이어야 하는 키는 맨 위에 경고로 표시됩니다.

가져온 앱에서는 무엇이 작동하나요?

미리보기, 대화, 편집 모드, 버전, QA가 모두 지금 코드 그대로 작동합니다. MonstarX는 앱의 기존 코드와 방식 안에서 작업하고, 필요한 패키지를 추가합니다.
게시: Vite 앱은 다른 앱처럼 MonstarX에서 게시됩니다. 자체 서버가 있는 앱은 기존 호스트가 게시합니다. 게시 → Vercel을 사용하거나, 호스트가 가져가는 GitHub에 저장하세요. 자세한 내용은 다른 호스팅를 참고하세요.
내보내기를 하면 이미지를 포함한 저장소가 그대로 나옵니다.
MonstarX 자체 데이터베이스와 계정은 추가되지 않습니다. 가져온 앱은 코드가 쓰던 것(Supabase, Firebase, 자체 API)을 계속 쓰고, 백엔드 → 데이터베이스에 그렇게 표시됩니다. 앱에 필요한 키는 백엔드 → 시크릿에 넣으세요.

monstarx 브랜치란 무엇인가요?

내 GitHub 계정을 연결한 상태에서 가져왔고 그 저장소에 푸시할 권한이 있으면, 프로젝트는 저장소와 연결된 상태로 유지됩니다. MonstarX는 가져온 커밋에서 monstarx라는 브랜치를 만들고 변경 사항을 거기에 저장합니다. 기본 브랜치는 그대로입니다. 변경 사항을 메인 브랜치에 반영하고 싶을 때 monstarx에서 풀 리퀘스트를 여세요. 프로젝트의 GitHub 메뉴에 GitHub 비교 페이지 링크가 있습니다. GitHub에서 그 브랜치에 푸시한 수정 사항도 MonstarX로 돌아옵니다. 자세한 내용은 GitHub을 참고하세요.

MonstarX에서 내 앱을 실행할 수 없다면요?

휴대폰 앱(Expo, React Native, Flutter, Swift, Android), 데스크톱 앱, Django, Rails, Laravel, Go 사이트는 검사 결과에 코드를 읽고 다시 만들기 계획 세우기 버튼이 나옵니다.

corner-bakery-phone.zip 검사 결과. 여기서 실행할 수 없음, Expo, React 19. 그대로 실행할 수는 없지만 MonstarX에서 다시 만들 수 있다는 제목과 함께, Expo로 만든 휴대폰 앱이라 화면, 데이터 모델, 코드 속 규칙을 유지한 채 휴대폰에서도 작동하는 웹 앱으로 다시 만들 수 있다는 설명, 그리고 코드를 읽고 다시 만들기 계획 세우기 버튼이 있습니다

MonstarX가 새 프로젝트를 만들고, 원본 코드를 옆에 읽기 전용으로 보관하고, 분석한 다음 다시 만들기 계획을 제안합니다. 화면, 데이터, 코드 속 규칙, 사용하는 서비스와 각각의 처리 방식(유지됨, 교체됨, 제외됨), 함께 옮겨지지 않는 것, 그대로 옮겨지는 로직이 담깁니다. 틀린 점을 말하면 계획이 수정되고, 만들기를 누르면 만들기 시작합니다. 원본은 세부 사항이 필요할 때마다 바로 찾아볼 수 있습니다. 여기서 실행되는 앱에도 대신 MonstarX에서 다시 만들기 버튼이 있습니다. MonstarX 자체 데이터베이스, 계정, 게시 기능을 쓰고 싶을 때 사용하세요.

가져올 수 있는 앱의 크기는 얼마인가요?

한도	값
코드	최대 파일 3,000개, 12 MB, 파일당 400 KB
이미지와 기타 파일	ZIP 가져오기는 최대 500 MB(GitHub에서는 100 MB), 파일당 10 MB
.zip	종속성과 빌드 결과물을 제외하기 전 기준 최대 500 MB
다시 만들기	최대 파일 1,500개, 코드 5 MB

한도를 넘으면 검사 결과에 해당 수치, 한도, 해결 방법이 표시됩니다. 대개 앱이 들어 있는 폴더만 가져오면 됩니다.

자주 묻는 질문

가져오면 내 GitHub 저장소가 바뀌나요?

기본 브랜치는 바뀌지 않습니다. 푸시 권한이 있으면 변경 사항이 monstarx 브랜치에 저장되고, 없으면 저장소를 읽기만 합니다.

모노레포도 가져올 수 있나요?

네. MonstarX가 앱이 들어 있는 폴더를 찾고, 검사 결과에서 다른 폴더를 고를 수도 있습니다.

MonstarX에서 내보낸 앱을 다시 가져올 수 있나요?

네. 완전한 MonstarX 프로젝트로 돌아옵니다(데이터베이스는 새로 비어 있는 상태이며, 이전 앱의 데이터는 원래 자리에 남습니다).

가져온 코드를 실행해도 안전한가요?

코드는 전용 보안 클라우드 컴퓨터에서 실행되고, 패키지는 설치 스크립트를 끈 상태로 설치됩니다.

다른 사람이 작성한 코드도 가져올 수 있나요?

사용할 권리가 있는 코드만 가져오세요. 검사 결과에 저장소의 라이선스가 표시되며, 라이선스가 없으면 명시되지 않았다고 알려 줍니다.