본문 바로가기
시작하기

새 앱 만들기

공식 스타터를 생성하고 Electron 앱을 실행합니다.

1. 프로젝트 생성

npm create frontron@latest my-app
cd my-app
npm install

생성된 앱은 웹 프론트엔드와 Electron 코드를 같은 저장소에서 관리합니다.

my-app/
├─ src/
│  ├─ electron/
│  │  ├─ main.ts
│  │  ├─ preload.ts
│  │  ├─ ipc.ts
│  │  └─ window.ts
│  ├─ App.tsx
│  └─ types/electron.d.ts
├─ package.json
├─ tsconfig.electron.json
└─ vite.config.ts

2. 데스크톱 앱 실행

npm run app

npm run dev는 브라우저용 Vite 서버만 실행합니다. Electron 창과 preload 브리지를 확인하려면 npm run app을 사용하세요.

3. 첫 수정

UI는 일반 React/Vite 프로젝트처럼 src/에서 수정합니다. 데스크톱 기능은 직접 Node API를 호출하지 않고 브리지 API를 사용합니다.

4. 배포 파일 만들기

npm run build

빌드 전에 타입 검사, 웹 빌드와 Electron 빌드가 순서대로 실행됩니다. 결과물과 플랫폼별 주의사항은 빌드와 배포를 참고하세요.