Files
twenty/packages/create-twenty-app/src/constants/base-application
Charles Bochet 905898d109 Twenty SDK command renaming and dev mode (#17245)
## Description

This PR improves the developer experience for the `twenty-sdk` and
`create-twenty-app` packages by reorganizing commands, adding
development tooling, and improving documentation.

## Changes

### twenty-sdk

#### Command Refactoring
- **Renamed `app-watch` → `app-dev`**: Renamed `AppWatchCommand` to
`AppDevCommand` and moved to `app-dev.ts` for consistent naming with the
CLI command `app:dev`
- **Moved `app-add` → `entity-add`**: Relocated entity creation logic
from `app/app-add.ts` to `entity/entity-add.ts` and renamed
`AppAddCommand` to `EntityAddCommand` for better separation of concerns

#### Development Tooling
- **Added `dev` target**: New Nx target `npx nx run twenty-sdk:dev` that
runs the build in watch mode for faster development iteration

### create-twenty-app

#### Improved Scaffolded Project
- **Enhanced base-application README** with:
  - Updated Getting Started to recommend `yarn dev` for development
  - Added "Available Commands" section listing all available scripts
  
#### Better Onboarding
- **Improved success message** after app creation with formatted next
steps:
2026-01-19 16:02:12 +01:00
..

This is a Twenty application project bootstrapped with create-twenty-app.

Getting Started

First, authenticate to your workspace:

yarn auth:login

Then, start development mode to sync your app and watch for changes:

yarn app:dev

Or run a one-time sync:

yarn app:sync

Open your Twenty instance and go to /settings/applications section to see the result.

Available Commands

# Authentication
yarn auth:login     # Authenticate with Twenty
yarn auth:logout    # Remove credentials
yarn auth:status    # Check auth status

# Application
yarn app:dev        # Start dev mode (sync + watch)
yarn app:sync       # One-time sync
yarn app:add        # Add a new entity (function, object, role)
yarn app:generate   # Generate typed Twenty client
yarn app:logs       # Stream function logs
yarn app:uninstall  # Uninstall app from workspace

Learn More

To learn more about Twenty applications, take a look at the following resources:

You can check out the Twenty GitHub repository - your feedback and contributions are welcome!