Application command는 app lifecycle 작업을 관리합니다. app 생성/삭제, generated surface sync, local server 시작, production build, typecheck/test, mobile app packaging, local database helper를 다룹니다.

대부분의 명령은 workspace context에서 app을 선택합니다. `--write`, `--target`, `--env`, `--regenerate` 같은 option은 code generation과 mobile build 동작을 제어합니다.

create-application

Create a new app folder and register it in the workspace application set. The app name is normalized to lowercase kebab-case, and `--start` can immediately run the application after generation.

Signature

Arguments

Argument	Type	Required	Default	Description
appName	String	yes	-	Application name. Normalized to lowercase kebab-case.

appName

Type

String

Required

yes

Default

Description

Application name. Normalized to lowercase kebab-case.

Options

Option	Type	Default	Enum / Flag	Description
--start	Boolean	false	-	Start application after creation.

--start

Type

Boolean

Default

false

Enum / Flag

Description

Start application after creation.

Examples

remove-application

Remove an existing application from the workspace. Use this when an app should no longer participate in workspace sync, builds, generated outputs, or deployment workflows.

Signature

Examples

sync

Synchronize dependency and configuration surfaces for a selected app or library. Run it after structural changes, package changes, or generated configuration changes that need to be reflected in the target system.

Signature

Examples

script

Run a custom script inside the selected application environment. The filename is optional, so the command can run the app script flow directly or target a specific script file when provided.

Signature

Arguments

Argument	Type	Required	Default	Description
filename	String	no	-	Script filename. Nullable.

filename

Type

String

Required

Default

Description

Script filename. Nullable.

Examples

build

Build the application for production, including frontend SSR output and backend/runtime artifacts. `--write` refreshes generated code first, while `--fast` and `--quiet` tune build speed and terminal output.

Signature

Options

Option	Type	Default	Enum / Flag	Description
--write	Boolean	true	-	Write code generation before running the command.
--fast	Boolean	false	-	Fast build.
--quiet	Boolean	false	-	Hide build progress output.

--write

Type

Boolean

Default

true

Enum / Flag

Description

Write code generation before running the command.

--fast

Type

Boolean

Default

false

Enum / Flag

Description

Fast build.

--quiet

Type

Boolean

Default

false

Enum / Flag

Description

Hide build progress output.

Notes

Name	Description
short	true

short

Description

true

Examples

typecheck

Run TypeScript type checking for the selected application. The command can regenerate code before checking, clear the typecheck cache with `--clean`, or reuse incremental cache with `--incremental`.

Signature

Options

Option	Type	Default	Enum / Flag	Description
--write	Boolean	true	-	Write code generation before running the command.
--clean	Boolean	false	-	Clear typecheck cache before running.
--incremental	Boolean	true	-	Reuse TypeScript incremental cache.

--write

Type

Boolean

Default

true

Enum / Flag

Description

Write code generation before running the command.

--clean

Type

Boolean

Default

false

Enum / Flag

Description

Clear typecheck cache before running.

--incremental

Type

Boolean

Default

true

Enum / Flag

Description

Reuse TypeScript incremental cache.

Notes

Name	Description
short	true

short

Description

true

Examples

test

Prepare generated surfaces and run tests for the selected app, library, or package target. Keep `--write` enabled when tests depend on generated routes, stores, services, or type surfaces being current.

Signature

Options

Option	Type	Default	Enum / Flag	Description
--write	Boolean	true	-	Write code generation before running the command.

--write

Type

Boolean

Default

true

Enum / Flag

Description

Write code generation before running the command.

Examples

build-ios

Build the iOS native project for an Akan application through Capacitor. Use `--target` to choose a mobile target, `--env` to bind the backend environment, and `--regenerate` when native project files must be recreated.

Signature

Options

Option	Type	Default	Enum / Flag	Description
--target	String	-	-	Mobile target name or all.
--env	String	debug	local \| debug \| develop \| main	Backend environment.
--write	Boolean	true	-	Write code generation before running the command.
--regenerate	Boolean	false	flag: -g	Delete and regenerate native project.

--target

Type

String

Default

Enum / Flag

Description

Mobile target name or all.

--env

Type

String

Default

debug

Enum / Flag

local | debug | develop | main

Description

Backend environment.

--write

Type

Boolean

Default

true

Enum / Flag

Description

Write code generation before running the command.

--regenerate

Type

Boolean

Default

false

Enum / Flag

flag: -g

Description

Delete and regenerate native project.

Notes

Name	Description
short	true

short

Description

true

Examples

build-android

Build the Android native project for an Akan application through Capacitor. Use `--target` for the mobile target, `--env` for the backend environment, and `--regenerate` when native project files need a fresh generation.

Signature

Options

Option	Type	Default	Enum / Flag	Description
--target	String	-	-	Mobile target name or all.
--env	String	debug	local \| debug \| develop \| main	Backend environment.
--write	Boolean	true	-	Write code generation before running the command.
--regenerate	Boolean	false	flag: -g	Delete and regenerate native project.

--target

Type

String

Default

Enum / Flag

Description

Mobile target name or all.

--env

Type

String

Default

debug

Enum / Flag

local | debug | develop | main

Description

Backend environment.

--write

Type

Boolean

Default

true

Enum / Flag

Description

Write code generation before running the command.

--regenerate

Type

Boolean

Default

false

Enum / Flag

flag: -g

Description

Delete and regenerate native project.

Notes

Name	Description
short	true

short

Description

true

Examples

start

Start the local development server for frontend SSR and backend runtime together. `--open` launches the browser after startup, and `--write` keeps generated application surfaces current before serving.

Signature

Options

Option	Type	Default	Enum / Flag	Description
--open	Boolean	false	-	Open web browser.
--write	Boolean	true	-	Write code generation before running the command.

--open

Type

Boolean

Default

false

Enum / Flag

Description

Open web browser.

--write

Type

Boolean

Default

true

Enum / Flag

Description

Write code generation before running the command.

Notes

Name	Description
short	true

short

Description

true

Examples

start-ios

Start the iOS app on a simulator or connected device. `--release` switches the mobile operation mode to release, while `--open`, `--env`, and `--target` control simulator launch and target environment.

Signature

Options

Option	Type	Default	Enum / Flag	Description
--target	String	-	-	Mobile target name or all.
--env	String	local	local \| debug \| develop \| main	Backend environment.
--open	Boolean	false	-	Open iOS simulator.
--release	Boolean	false	-	Release mode.
--write	Boolean	true	-	Write code generation before running the command.
--regenerate	Boolean	false	flag: -g	Delete and regenerate native project.

--target

Type

String

Default

Enum / Flag

Description

Mobile target name or all.

--env

Type

String

Default

local

Enum / Flag

local | debug | develop | main

Description

Backend environment.

--open

Type

Boolean

Default

false

Enum / Flag

Description

Open iOS simulator.

--release

Type

Boolean

Default

false

Enum / Flag

Description

Release mode.

--write

Type

Boolean

Default

true

Enum / Flag

Description

Write code generation before running the command.

--regenerate

Type

Boolean

Default

false

Enum / Flag

flag: -g

Description

Delete and regenerate native project.

Notes

Name	Description
short	true
operation	release when --release is true, otherwise local

short

Description

true

operation

Description

release when --release is true, otherwise local

Examples

start-android

Start the Android app on an emulator or connected device. The command mirrors the iOS start flow, with environment selection, release mode, emulator opening, code generation, and native regeneration controls.

Signature

Options

Option	Type	Default	Enum / Flag	Description
--target	String	-	-	Mobile target name or all.
--env	String	local	local \| debug \| develop \| main	Backend environment.
--release	Boolean	false	-	Release mode.
--open	Boolean	false	-	Open android simulator.
--write	Boolean	true	-	Write code generation before running the command.
--regenerate	Boolean	false	flag: -g	Delete and regenerate native project.

--target

Type

String

Default

Enum / Flag

Description

Mobile target name or all.

--env

Type

String

Default

local

Enum / Flag

local | debug | develop | main

Description

Backend environment.

--release

Type

Boolean

Default

false

Enum / Flag

Description

Release mode.

--open

Type

Boolean

Default

false

Enum / Flag

Description

Open android simulator.

--write

Type

Boolean

Default

true

Enum / Flag

Description

Write code generation before running the command.

--regenerate

Type

Boolean

Default

false

Enum / Flag

flag: -g

Description

Delete and regenerate native project.

Notes

Name	Description
short	true
operation	release when --release is true, otherwise local

short

Description

true

operation

Description

release when --release is true, otherwise local

Examples

release-ios

Build and package the iOS app for App Store release workflows. The command defaults to the `main` backend environment and requires explicit `--allowLocalRelease` if a local release environment must be allowed.

Signature

Options

Option	Type	Default	Enum / Flag	Description
--target	String	-	-	Mobile target name or all.
--env	String	main	debug \| develop \| main \| local	Backend environment.
--write	Boolean	true	-	Write code generation before running the command.
--regenerate	Boolean	false	flag: -g	Delete and regenerate native project.
--allowLocalRelease	Boolean	false	flag: -l	Allow release with --env local.

--target

Type

String

Default

Enum / Flag

Description

Mobile target name or all.

--env

Type

String

Default

main

Enum / Flag

debug | develop | main | local

Description

Backend environment.

--write

Type

Boolean

Default

true

Enum / Flag

Description

Write code generation before running the command.

--regenerate

Type

Boolean

Default

false

Enum / Flag

flag: -g

Description

Delete and regenerate native project.

--allowLocalRelease

Type

Boolean

Default

false

Enum / Flag

flag: -l

Description

Allow release with --env local.

Examples

release-android

Build and package the Android app for Play Store release workflows. `--assembleType` selects APK or AAB output, while environment, target, regeneration, and local-release options control the release artifact.

Signature

Options

Option	Type	Default	Enum / Flag	Description
--assembleType	String	apk	apk \| aab	Android artifact type.
--target	String	-	-	Mobile target name or all.
--env	String	main	debug \| develop \| main \| local	Backend environment.
--write	Boolean	true	-	Write code generation before running the command.
--regenerate	Boolean	false	flag: -g	Delete and regenerate native project.
--allowLocalRelease	Boolean	false	flag: -l	Allow release with --env local.

--assembleType

Type

String

Default

apk

Enum / Flag

apk | aab

Description

Android artifact type.

--target

Type

String

Default

Enum / Flag

Description

Mobile target name or all.

--env

Type

String

Default

main

Enum / Flag

debug | develop | main | local

Description

Backend environment.

--write

Type

Boolean

Default

true

Enum / Flag

Description

Write code generation before running the command.

--regenerate

Type

Boolean

Default

false

Enum / Flag

flag: -g

Description

Delete and regenerate native project.

--allowLocalRelease

Type

Boolean

Default

false

Enum / Flag

flag: -l

Description

Allow release with --env local.

Examples

release-source

Release application source code for mobile OTA-oriented update workflows. Use build number, environment, rebuild, and local flags to describe the source release payload sent through the update process.

Signature

Options

Option	Type	Default	Enum / Flag	Description
--rebuild	Boolean	false	-	Rebuild before release source.
--buildNum	Number	0	-	Build number.
--environment	String	debug	-	Environment.
--local	Boolean	true	-	Local mode.

--rebuild

Type

Boolean

Default

false

Enum / Flag

Description

Rebuild before release source.

--buildNum

Type

Number

Default

Enum / Flag

Description

Build number.

--environment

Type

String

Default

debug

Enum / Flag

Description

Environment.

--local

Type

Boolean

Default

true

Enum / Flag

Description

Local mode.

Examples

codepush

Deploy an over-the-air update for the selected mobile application. The command prompts for the target OS (`ios` or `android`) before running the OTA deployment flow.

Signature

Notes

Name	Description
interactive	Prompts for os: ios or android.

interactive

Description

Prompts for os: ios or android.

Examples

dbup

Start local database services for the selected workspace database topology. `--mode` selects single, multiple, or cluster mode so local infrastructure can match the workflow being tested.

Signature

Options

Option	Type	Default	Enum / Flag	Description
--mode	String	multiple	single \| multiple \| cluster	Database mode.

--mode

Type

String

Default

multiple

Enum / Flag

single | multiple | cluster

Description

Database mode.

Examples

dbdown

Stop local database services started for development or verification. Use it after local database-dependent workflows are complete to cleanly shut down the workspace database environment.

Signature

Examples

configure-app

Run the interactive application configuration flow for a selected app. Use it when app settings need to be inspected or updated through prompts rather than manual config edits.

Signature

Notes