Skip to main content

Projects

Available in product editions: TeamProfessional

Overview​

Projects are the fundamental organizational unit in workbench, serving as containers for all design, modeling, and implementation work. Each project represents a cohesive unit of work—whether it's a microservice, a frontend application, an architectural design, or a complete system composition.

Key Characteristics​

  • Git-backed: Every project is backed by a Git repository, ensuring version control, collaboration capabilities, and traceability of all changes
  • Baseline-driven: Projects are created from baselines that define the modeling vocabulary, profiles, and implementation recipes available within the project
  • Type-specific: Projects can be of different types (Architecture, Implementation, Composition) depending on their purpose and the work they contain
  • Self-contained: Each project maintains its own design graph, configuration, and generated artifacts

Projects Page​

The Projects page serves as the central hub for managing and navigating all projects within your workbench instance. It provides a comprehensive overview with powerful filtering, search, and customization capabilities to help you quickly locate and access the projects you need.

Display and Layout​

Projects are presented in a card-based layout, where each card represents a single project and displays key information at a glance. This visual approach makes it easy to scan multiple projects and identify the one you need quickly.

Default Information Displayed​

Each project card displays the following information by default:

  • Acronym: A short identifier for quick recognition of the project
  • Name: The full project name providing clear identification
  • Description: A brief summary explaining the project's purpose and scope
  • Tags: Labels for categorizing and filtering projects by domain, team, or other criteria
  • Baseline: The baseline used to create the project, which defines the available modeling vocabulary and profiles
  • Baseline Version: The specific version of the baseline, important for understanding available features and compatibility
  • Git Provider: The Git hosting service (GitHub, GitLab, Bitbucket, etc.) where the project repository is stored

Customization Options​

The Projects page offers extensive customization capabilities to tailor the view to your specific needs:

Search and Filtering​

The page includes powerful search functionality that enables you to:

  • Text Search: Quickly find projects by name, description, acronym, or other text fields
  • Tag Filtering: Filter projects by one or multiple tags to focus on specific domains or categories
  • Baseline Filtering: View only projects using specific baselines or baseline versions
  • Provider Filtering: Filter by Git provider to see projects hosted on specific platforms

Advanced Table Configuration​

Beyond basic search and filtering, the Projects page supports advanced table-related configurations:

Sorting​

  • Multi-column Sorting: Sort projects by any displayed field (name, creation date, last modified, etc.)
  • Ascending/Descending: Toggle sort order to organize projects in the most useful way
  • Persistent Preferences: Your sorting preferences are saved and applied automatically on subsequent visits

View Options​

  • Density Control: Adjust the spacing and size of project cards for compact or comfortable viewing
  • Pagination: Control how many projects are displayed per page
  • Column Selection: Choose which columns to display in list view (if available)

From the Projects page, you can:

  • Open Projects: Click on a project card to open it and access its design canvas, models, and generated code
  • Create New Projects: Initiate the project creation workflow to start a new project
  • Quick Actions: Access common project operations directly from the card (depending on permissions)