Skip to main content

Projects

Projects are the main organizational unit in Erold. Each project contains tasks, has its own settings, and can have specific team access.

Creating a Project

  1. Click "New Project" from the dashboard
  2. Enter a name for your project
  3. Choose a project key (2-5 uppercase letters)
  4. Add an optional description
  5. Click "Create"

The project key is used in task IDs. For example, if your key is "MYAPP", tasks will be numbered MYAPP-1, MYAPP-2, etc.

Project Settings

Each project can be customized with:

Custom Statuses

Define your own workflow statuses beyond the defaults (Todo, In Progress, Done). Add statuses like "In Review", "Blocked", or "Testing".

Labels

Create labels to categorize tasks. Common examples:

  • bug - Bug fixes
  • feature - New features
  • docs - Documentation
  • refactor - Code refactoring

Default Assignee

Optionally set a default assignee for new tasks in the project.

Project Views

Erold supports multiple views:

  • List View - Traditional list with sorting and filtering
  • Board View - Kanban-style drag-and-drop

Archive & Delete

Archive a project to hide it from the main view while preserving all data. Archived projects can be restored.

Delete permanently removes the project and all tasks. This cannot be undone.

API & CLI

# Create a project via CLI
erold project create "My Project" --key MYPROJ

# List projects
erold project list

# Via API
curl -X POST https://api.erold.dev/v1/projects \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Project", "key": "MYPROJ"}'

Next Steps