CLI 레퍼런스

# 프로젝트 devDependency로 설치 (권장)
npm install -D @asapjs/cli
 
# 전역 설치
npm install -g @asapjs/cli
 
# npx로 직접 실행
npx @asapjs/cli <command>

asapjs new <name> [options]

my-project/
├── src/
│   ├── index.ts      # 애플리케이션 진입점 (Application 인스턴스 생성)
│   ├── config.ts     # 설정 파일 (extensions, swagger, db 등)
│   └── route.ts      # 라우트 정의 (빈 배열)
├── .asapjs.json      # CLI 설정 파일
├── .env              # 환경 변수
├── .env.local        # 로컬 환경
├── .env.dev          # 개발 환경
├── .env.prod         # 프로덕션 환경
├── .gitignore
├── package.json
└── tsconfig.json

asapjs new my-api
cd my-api
asapjs dev

asapjs dev [options]

# 기본 (local 환경)
asapjs dev
 
# 개발 환경, 포트 지정
asapjs dev --env development --port 4000

asapjs build [options]

# 기본 프로덕션 빌드
asapjs build
 
# 개발 환경, 커스텀 출력
asapjs build --env development --output build

cd dist
npm install --production
asapjs start

asapjs start [options]

# 기본
asapjs start
 
# 커스텀 디렉토리
asapjs start --dir build

asapjs generate <type> <name> [options]
# 단축형
asapjs g <type> <name> [options]

# 컨트롤러 생성
asapjs g controller User
# → src/UserController.ts
 
# 서비스 생성 (커스텀 경로)
asapjs g service Post --path src/modules
# → src/modules/PostService.ts
 
# DTO 생성
asapjs g dto CreateUser
# → src/CreateUserDto.ts

{
  "environments": {
    "local": {
      "envFile": ".env.local",
      "port": 3000
    },
    "development": {
      "envFile": ".env.dev",
      "port": 4000
    },
    "production": {
      "envFile": ".env.prod",
      "port": 8080
    }
  },
  "build": {
    "outDir": "dist",
    "sourceMap": true
  }
}

# 1. 프로젝트 생성
asapjs new my-api
cd my-api
 
# 2. 컴포넌트 스캐폴딩
asapjs g controller User
asapjs g service User
asapjs g dto CreateUser
 
# 3. 개발
asapjs dev                    # 로컬 개발 서버
asapjs dev --env development  # 개발 환경
 
# 4. 빌드 및 배포
asapjs build                  # 프로덕션 빌드
cd dist && npm install --production
asapjs start                  # 프로덕션 실행