The user creates a new app project by providing a name and description. The system provisions a project record and prepares the local workspace directory. The project starts in ACTIVE status and is ready for vibecoding conversations.
stateDiagram-v2
[*] --> DRAFT: User fills in project name & description
DRAFT --> ACTIVE: User submits → project created, workspace provisioned
ACTIVE --> ARCHIVED: User archives the project
ARCHIVED --> ACTIVE: User restores the project
ACTIVE --> DELETED: User permanently deletes project
ARCHIVED --> DELETED: User permanently deletes project
DELETED --> [*]
States
| State | Description | Transitions |
|---|---|---|
| DRAFT | UI form being filled (client-side only, not persisted) | → ACTIVE (submit) |
| ACTIVE | Project is live and available for conversations | → ARCHIVED, → DELETED |
| ARCHIVED | Project is hidden from main list but data is preserved | → ACTIVE (restore), → DELETED |
| DELETED | Project and all related data permanently removed | → [end] |
Business Rules
- Project name must be unique within a tenant
- A local workspace directory is created on the host machine when the project is persisted
- Deleting a project removes all conversations, messages, versions, and the workspace directory
- Archived projects cannot start new conversations
Was this page helpful?
Thanks for the feedback.