시작하기

Akan.js는 실제 비즈니스를 코드로 설계하고 구현하는 것을 최우선으로 하는 풀스택 TypeScript 프레임워크입니다.

최소한의 코드로 타입 안전한 서비스를 만들어 웹, 모바일, 서버, DB 인프라에 동시에 배포할 수 있습니다.

이 가이드는 빈 디렉터리에서 실행 중인 앱까지 안내합니다.

요구사항

첫 실행에는 Bun만 있으면 됩니다.

Bun 1.4.0 이상

소스코드 관리를 위한 Git

네이티브 앱 빌드를 위한 Android Studio 또는 Xcode

워크스페이스 생성

가장 빠른 방법은 코딩 에이전트에게 맡기는 것입니다. 빈 디렉터리에서 Claude Code나 Codex를 열고 이 프롬프트를 붙여 넣으세요. Bun을 확인하고 워크스페이스를 만든 뒤 앱까지 띄웁니다:

Akan.js(https://akanjs.com) 워크스페이스를 새로 만들어 줘.

1. Bun 1.4 이상이 설치돼 있는지 확인해 줘(`bun --version`). 없거나 버전이 낮으면 https://bun.sh 안내대로 설치하거나 업그레이드해 줘.
2. 워크스페이스 이름과 첫 앱 이름을 물어봐 줘. 짧은 영문 소문자로, 아래에 적어 뒀다면 그걸 쓰면 돼.
3. 이 디렉터리에서 `bunx create-akan-workspace@latest <워크스페이스> --app <앱>`을 실행해 줘. akan CLI를 전역으로 설치하고, ./<워크스페이스>를 만들어 의존성까지 설치해.
4. ./<워크스페이스> 안에서 `akan start <앱>`으로 개발 서버를 백그라운드에 띄우고, 출력된 주소(기본 http://localhost:8282)가 열리는지 확인해 줘.
5. 다 되면 알려 주고, ./<워크스페이스> 안에서 너를 다시 열라고 안내해 줘. 프로젝트의 Akan MCP 서버와 AGENTS.md 규칙은 거기서 로드돼.

직접 만들려면 workspace creator를 실행합니다. 워크스페이스 이름과 앱 이름을 묻습니다:

Terminal

또는 전역 설치된 akan 명령을 사용합니다:

Terminal

앱 실행

명령 하나로 앱을 시작합니다:

Terminal

앱은 http://localhost:8282 에서 열립니다.

페이지 수정하기

Akan page는 apps/<app>/page 아래에 있습니다. 첫 화면을 수정하고 새로고침합니다:

apps/myapp/page/_index.tsx

http://localhost:8282

Hello Akan.js! 🎉

앱 엔트리 이해하기

생성된 main.ts가 Akan runtime을 시작합니다.

apps/myapp/main.ts

터미널에서 local runtime 상태를 확인할 수 있습니다.

Terminal

빌드

production build를 실행합니다:

Terminal

결과물은 dist/apps/myapp 디렉터리에 생성됩니다.

다음기본 개념