跳到主要内容

Getting Started

The board is a powerful project management tool provided by GitCode, helping teams efficiently organize, track, and collaborate on project progress. This guide will help you quickly master the core features of the board, from creation to daily usage.

提示

Before using the board feature, please ensure:

  • You have created or joined an organization
  • A project has been created within the organization
  • You have the appropriate permissions

For more details, please refer to the New Organization documentation.

1. Create a Board


  1. Navigate to the organization homepage, click on the "Board" tab in the top navigation bar to enter the board list page

    image-20250102143347493

  2. Click the "New Board" button, the system will automatically create a board with a default template

    image-20250102143441089

  3. A new board has been successfully created

    image-20250102144256703

Limitations

Currently, the board only supports up to 1200 rows (1200 tasks) and 50 columns (including system fields).

When creating a board, it will include the following system fields by default:

  • Title, Title
  • Assignees, Assignee
  • Labels, Labels
  • Linked pull request, Linked PR
  • Reviewers PR, Reviewer
  • Repository, Repository
  • Milestone, Milestone

2. Set Up the Board


  1. You can perform some custom settings for the board, click on the "Board Settings" at the top right corner to enter the board settings page

    image-20250102143728081

  2. On the settings page, fill in: Board name (required), Description (optional), Visibility (public/private), and click "Update Settings" to complete the basic configuration

    image-20250102143909388

  3. Return to the board page to see the updated board name

    image-20250102144534456

3. Create a View


  1. On the board page, click "New View" to create a new default view

    image-20250102144652414

  2. Expand the "More" options of the view, you can rename, delete, and export data of the view

    image-20250102144830606

  3. The buttons "Show Fields", "Sort", and "Group" are used to configure the fields displayed in the view, the sorting rules for tasks, and the grouping rules for tasks. After configuration, click "Save Changes" to persist the settings

    image-20250102145722536

4. Customize Fields


  1. In the board settings, click "Add Field" to open the "Custom Field Settings" page, enter the field name, and select the field type

    image-20250102150431029

    There are four types of fields, here are examples of creating four types of fields

    image-20250102150750739

    image-20250102150946231

    image-20250102151029810

    image-20250102151234249

  2. After configuring the display fields on the view page, you can see the following effect

    image-20250102151819469


提示

Currently, the board only supports up to 1200 rows (1200 tasks), 50 columns (including system fields)

  1. On the view page, click the "Click to link existing tasks" button to expand the task selection drawer. You can filter by project, select Issues and PRs, and click Add to complete the linking operation

    image-20250102152431710

  2. Return to the view page, the tasks have been linked to the board, fill in the relevant columns

    image-20250102152756131

6. Modify Task Status


In Table View:

On the view page, find the target task, click on its status column, and select the new status from the drop-down menu

image-20250102153116905

In Board View:

Find the target task card, drag the card to the target status lane, and release to update the status

image-20250102153403880

7. Board Statistics


  1. Click the "Statistics" button at the top right corner of the view page to expand the statistics page

    image-20250102154133778

  2. On the statistics page, you can create statistical charts, configure each chart's display (chart type, grouping method, X-axis, Y-axis). After configuring the chart, click "Save Chart" to persist the settings

    image-20250102154811115

Through the above steps, you can quickly create and set up a board, add views, customize fields, link tasks, and modify task statuses. The intuitive interface and flexible features of the board help teams collaborate efficiently and ensure clear visibility of project progress. Start using the board now and make your project management more organized!