개발자

개발

EveryOS를 빌드하고 검증하며 프로젝트에 기여하세요.

소스 실행

macOS 또는 Linux에서 Node.js 26과 pnpm 12를 사용하세요. 개발용 데스크톱은 http://127.0.0.1:5173에서 열리며 콘솔에 임시 설정 토큰이 표시됩니다. Linux 전용 기능은 macOS에서 사용할 수 없다고 표시됩니다. 이 소스 실행 절차는 패키지 설치와 별개입니다.

Bash
git clone https://github.com/goktugcy/everyos.git
cd everyos
pnpm install
pnpm dev

변경 사항 검증

pnpm check는 형식 검사, 린트, 타입 검사, 테스트를 실행합니다. 브라우저 테스트 전에 빌드하세요. 첫 실행 시 pnpm exec playwright install --only-shell chromium으로 Chromium을 설치하세요. 테스트는 일회용 상태를 사용해야 하며 운영 중인 작업 공간을 대상으로 해서는 안 됩니다.

Bash
pnpm check
pnpm build
pnpm test:e2e

아키텍처 살펴보기

프로젝트는 React 클라이언트, Hono API, SQLite 데이터베이스, 권한을 가진 에이전트, 독립적인 업데이트 워커로 구성됩니다. 신뢰 경계를 변경하기 전에 CONTRIBUTING.md와 아키텍처 가이드를 읽으세요. 서드파티 데스크톱 앱은 저장소의 docs/app-sdk에서 시작하세요.