index.ts, cnst.ts, st.ts 같은 배럴 파일, akan.<app|lib>.json, 범위별 AGENTS.md입니다.

코드가 import하는 패키지를 루트와 같은 버전으로 자기 package.json에 적습니다.

lib 에셋을 public/libs에 연결하고, syncPageLibs를 켰다면 lib 라우트도 page/(libs)에 연결합니다.

start, build, typecheck, test는 --write로 이 작업을 먼저 실행합니다.

앱, 앱이 닿는 모든 lib, 이를 감싸는 워크스페이스 뼈대, 루트 package.json입니다.

파일 목록을 git에서 가져오므로 env 값처럼 gitignore된 파일은 빠집니다.

슬라이스가 import하는 패키지만 워크스페이스의 버전 그대로 남깁니다.

앱이나 lib 아래의 추적되지 않는 파일은 git이 옮기지 않으므로 경고로 나열합니다.

akan s로도 실행합니다.

파이프, 리다이렉트, 크기를 알 수 없는 터미널에서는 저절로 --plain이 됩니다.

앱마다 local/apps/<app>/runtime/dev.log에 기록합니다. 앱 하나를 --plain으로 띄울 때만 빠집니다.

AKAN_MEMORY_LIMIT을 주면 --concurrency 계산에 쓰는 메모리가 줄어듭니다.

Docker 데몬이 실행 중이어야 합니다. 이미 떠 있는 서비스는 그대로 둡니다.

local/docker-compose.yaml은 처음 실행할 때 만들어지고, 그 뒤로는 직접 관리합니다.

예전 compose 파일에는 서비스가 빠져 있을 수 있습니다. 직접 더하거나, 파일을 치워 두면 현재 템플릿으로 새로 만듭니다.

셸의 AKAN_DATABASE_MODE, 없으면 앱이 처음으로 선언한 모드입니다.

배포된 single 앱이라면 SQLite 파일을 복사하고 SQLITE_DATABASE_PATH가 그 복사본을 가리키게 합니다.

요청을 받지 않고 cron과 init 작업도 돌리지 않는 채로 앱을 띄웁니다.

행은 저장된 그대로, 삭제된 행까지 옮겨집니다. 이미 있는 id는 덮어쓰므로 다시 실행해도 됩니다.

가져오기가 끝나면 검색 인덱스를 다시 만듭니다.

세션과 대기 중인 작업은 옮기지 않으므로 사용자는 다시 로그인합니다. local/의 업로드 파일은 직접 복사합니다.

요청을 받지 않고 cron과 init 작업도 돌리지 않는 채로 앱을 띄웁니다.

요청을 받지 않고 internal 작업도 돌리지 않는 별도 서버를 띄웁니다. main.js에 붙지 않습니다.

프롬프트에서 srv, sig, db, cnst, dict, option을 바로 씁니다.

빌드된 컨테이너나 pod 안에서는 AKAN_CONSOLE=1 bun console.js를 실행합니다.

main 환경, cloud·edge 모드, NODE_ENV=production에서는 AKAN_CONSOLE=1 없이 열리지 않습니다.

akan console에서도 .tail과 .trace <id>로 같은 필터를 씁니다.

akan t로도 실행합니다.

akan b로도 실행합니다.

SSR과 CSR 단계는 akan.config.ts의 web 설정을 따르며, 꺼 둔 쪽은 건너뜁니다.

akan si로도 실행합니다.

--release 없이 실행하면 앱이 dev gateway를 거쳐 akan start <app>에서 화면을 불러오므로 저장할 때마다 반영됩니다. 개발 서버를 켜 두세요. 꺼져 있으면 명령이 그렇게 알리고 멈춥니다.

네이티브 타깃을 한 번에 하나만 실행합니다. 여럿이면 --target <name>을 줍니다.

개발 빌드는 dist/native/<app>/<target>/dev/ios, --release 실행은 …/build/ios 아래에 만들어집니다.

akan sa로도 실행합니다.

--release 없이 실행하면 앱이 dev gateway를 거쳐 akan start <app>에서 화면을 불러오므로 저장할 때마다 반영됩니다. 개발 서버를 켜 두세요. 꺼져 있으면 명령이 그렇게 알리고 멈춥니다.

네이티브 타깃을 한 번에 하나만 실행합니다. 여럿이면 --target <name>을 줍니다.

개발 빌드는 dist/native/<app>/<target>/dev/android, --release 실행은 …/build/android 아래에 만들어집니다.

akan sd로도 실행합니다.

--release 없이 실행하면 앱이 dev gateway를 거쳐 akan start <app>에서 화면을 불러오므로 저장할 때마다 반영됩니다. 개발 서버를 켜 두세요. 꺼져 있으면 명령이 그렇게 알리고 멈춥니다.

서버를 싣는 타깃이면, 앱의 개발 포트에서 이미 응답하는 개발 서버가 있을 때 그대로 씁니다. 없으면 같은 명령에서 akan start <app>을 띄우고, 서버가 응답하면 앱을 엽니다. Ctrl+C를 누르거나 앱을 닫으면 둘 다 멈춥니다. --env는 개발 서버에 영향을 주지 않고, 개발 서버는 워크스페이스 .env를 따릅니다.

akan.config.ts에 native: { desktop: { server: true } }를 주거나 한 타깃에 desktop.server를 주면, 데스크톱 앱이 앱의 서버를 싣습니다. 서버는 창과 함께 loopback 포트로 뜨고, 페이지는 그 서버만 부릅니다. build-desktop, start-desktop --release, publish-update가 모두 이 값을 읽습니다. 설치된 앱은 서버를 더하거나 빼는 업데이트를 받지 않으므로, 이미 배포한 앱에서 켜거나 끄려면 다시 설치해야 합니다.

앱에 든 Bun으로 API만 서빙하는 서버이며 127.0.0.1에 바인딩합니다. 이 컴퓨터의 어떤 프로그램이든 부를 수 있으므로 엔드포인트는 네트워크 서버처럼 가드합니다. 앱의 database.modes에 single이 있어야 하고, 데이터는 앱 데이터 폴더의 server/에 둡니다. private/(lib의 것도), --env의 env.server.<env>.ts, lib의 서버 env 기본값이 평문으로 실리므로 비밀과 라이선스 파일은 두지 마세요. public/이 없고 데이터 폴더에서 돌므로, 실행 중에 읽는 파일은 process.cwd()가 아니라 AKAN_APP_DIR 기준으로 읽습니다. 이미지의 docker 단계는 실행하지 않으며, 설치하면서 스스로 빌드하는 패키지는 trustedDependencies에 적습니다.

akan.config.ts의 bin에 적은 실행 파일은 이 컴퓨터용으로 받아 서버를 싣는지와 상관없이 모든 데스크톱 앱에 들어갑니다. 앱의 PATH 맨 앞에 있으므로 내장 서버의 spawn("ffmpeg")가 그 파일을 실행하고, 네이티브 플러그인은 ctx.binDir에서 찾습니다.

네이티브 타깃을 한 번에 하나만 실행합니다. 여럿이면 --target <name>을 줍니다.

개발 빌드는 dist/native/<app>/<target>/dev/<macos|windows|linux>, --release 실행은 …/build/<macos|windows|linux> 아래에 만들어집니다.

akan bi로도 실행합니다.

dist/native/<app>/<target>/build/ios 아래에 만들어지며, 명령이 파일마다 경로를 출력합니다.

akan ba로도 실행합니다.

~/.akan/native/debug.keystore로 서명하므로 테스트용입니다. Play Store에 낼 파일은 release-android로 만듭니다.

dist/native/<app>/<target>/build/android 아래에 만들어지며, 명령이 파일마다 경로를 출력합니다.

akan bd로도 실행합니다.

akan.config.ts에 native: { desktop: { server: true } }를 주거나 한 타깃에 desktop.server를 주면, 데스크톱 앱이 앱의 서버를 싣습니다. 서버는 창과 함께 loopback 포트로 뜨고, 페이지는 그 서버만 부릅니다. build-desktop, start-desktop --release, publish-update가 모두 이 값을 읽습니다. 설치된 앱은 서버를 더하거나 빼는 업데이트를 받지 않으므로, 이미 배포한 앱에서 켜거나 끄려면 다시 설치해야 합니다.

앱에 든 Bun으로 API만 서빙하는 서버이며 127.0.0.1에 바인딩합니다. 이 컴퓨터의 어떤 프로그램이든 부를 수 있으므로 엔드포인트는 네트워크 서버처럼 가드합니다. 앱의 database.modes에 single이 있어야 하고, 데이터는 앱 데이터 폴더의 server/에 둡니다. private/(lib의 것도), --env의 env.server.<env>.ts, lib의 서버 env 기본값이 평문으로 실리므로 비밀과 라이선스 파일은 두지 마세요. public/이 없고 데이터 폴더에서 돌므로, 실행 중에 읽는 파일은 process.cwd()가 아니라 AKAN_APP_DIR 기준으로 읽습니다. 이미지의 docker 단계는 실행하지 않으며, 설치하면서 스스로 빌드하는 패키지는 trustedDependencies에 적습니다.

akan.config.ts의 bin에 적은 실행 파일은 이 컴퓨터용으로 받아 서버를 싣는지와 상관없이 모든 데스크톱 앱에 들어갑니다. 앱의 PATH 맨 앞에 있으므로 내장 서버의 spawn("ffmpeg")가 그 파일을 실행하고, 네이티브 플러그인은 ctx.binDir에서 찾습니다.

현재 사용자로 %LOCALAPPDATA%\Programs 아래에 설치하므로 업데이트가 관리자 권한 없이 앱을 바꾸고, WebView2 Runtime이 없는 PC에는 함께 설치합니다. /S는 무인 설치, /RUN은 설치 뒤 실행입니다.

/D=<folder>로 설치 폴더를 고릅니다. 이것 없이 다시 실행하면 앱이 이미 있는 폴더에 설치하고, 다른 설치 프로그램이 도는 동안 띄운 것은 시작하지 않습니다.

dist/native/<app>/<target>/build/<macos|windows|linux> 아래에 만들어지며, 명령이 파일마다 경로를 출력합니다.

이 Mac에 Xcode가 둔 인증서와 프로필 중에서 찾습니다. 프로필은 app id와 앱이 요청하는 모든 capability를 덮어야 합니다. 명령이 쓴 서명을 출력합니다.

dist/native/<app>/<target>/build/ios 아래에 만들어지며, 명령이 파일마다 경로를 출력합니다.

환경 변수가 가리키는 업로드 키로 서명합니다. MYAPP_RELEASE_STORE_FILE, MYAPP_RELEASE_STORE_PASSWORD, MYAPP_RELEASE_KEY_ALIAS, 키에 비밀번호가 따로 있으면 MYAPP_RELEASE_KEY_PASSWORD도 둡니다. 하나라도 없으면 빌드 전에 멈춥니다.

dist/native/<app>/<target>/build/android 아래에 만들어지며, 명령이 파일마다 경로를 출력합니다.

akan.config.ts에 native: { desktop: { server: true } }를 주거나 한 타깃에 desktop.server를 주면, 데스크톱 앱이 앱의 서버를 싣습니다. 서버는 창과 함께 loopback 포트로 뜨고, 페이지는 그 서버만 부릅니다. build-desktop, start-desktop --release, publish-update가 모두 이 값을 읽습니다. 설치된 앱은 서버를 더하거나 빼는 업데이트를 받지 않으므로, 이미 배포한 앱에서 켜거나 끄려면 다시 설치해야 합니다.

앱은 updates.channel, 없으면 빌드할 때의 --env 채널로 릴리스를 받습니다. 그 --env로 게시합니다.

릴리스는 빌드할 때의 채널을 가집니다. pilot 그룹에는 updates.channel이 pilot인 타깃을 씁니다.

채널의 직전 릴리스와 서버 유무가 다르면, 설치된 앱이 거부할 것이므로 빌드 전에 거부합니다. 다른 채널(updates.channel)로 게시하거나 출력 폴더에서 그 <channel>.json을 지워 새로 시작합니다.

updates.url에 닿는 누구나 릴리스를 읽을 수 있고, 업데이터는 인증 정보를 보내지 않습니다. 데스크톱 릴리스는 앱 전체이므로 내장 서버의 private/와 env 파일도 들어 있습니다.