Git

integrations for your WorkplaceReading time: 6 minutes

Version control systems are tools to track changes, maintain a history of modifications, and enable project collaboration. They help manage project files, ensure consistency across versions, and streamline teamwork by organizing contributions from multiple users.

Timebook supports integration with version control systems by connecting with Git, one of the most popular and widely used options. Once you integrate Timebook with Git using one of the methods below, you will notice that:

• We will automatically turn on Bitbucket or GitHub webhooks for Git commits and pull requests. You can turn them off with the dedicated toggle.

• Cards of several Timebook objects will show the dedicated [Git] field where you can find all the Git information relevant to a given object.

You can integrate with Git using different services.

When you open the [Git] tab in the [Integrations] section, you must first select the provider you want to integrate with.

Integrating Timebook with Bitbucket

1. Click the dropdown next to your Workplace's name in the top-left corner.

2. From the resulting menu, select [Workplace settings] and open the [Integrations] tab from the menu on the left.

3. In the [Version control] tab, select the [Bitbucket] option and click [Integrate].

4. Use the toggle at the top to [Enable Bitbucket branch creation]. You must now provide the following:

   • Your [User name] in Bitbucket.

   • The [App password] you generated in Bitbucket. For more information on app password creation, see this Bitbucket help page.

   • Your Bitbucket [Namespace]. For more information on namespaces, see this GitLab help page.

5. Once we verify these credentials, you can start adding Bitbucket repositories. To do so, select a repository from the dropdown list and provide your access token. For more information on repository access tokens, see this Bitbucket help page.

Integrating Timebook with GitHub

1. Click the dropdown next to your Workplace's name in the top-left corner.

2. From the resulting menu, select [Workplace settings] and open the [Integrations] section from the menu on the left.

3. In the [Version control] tab, select the [GitHub] option and click [Integrate].

4. Use the toggle at the top to [Enable GitHub branch creation]. You must now provide your GitHub organization and access token. For more information on access tokens, see this GitHub help page. Remember to select appropriate scopes for your token. Scopes define the accessibility of GitHub repositories in Timebook.

5. Once we verify your access token, you will see additional options:

   • The [Enable GitHub integration] toggle to turn the integration on and off.

   • The [Trash] icon to remove this integration from your Timebook Workplace.

   • The [GitHub repository list] to connect additional repositories.

Integrating Timebook with GitLab

1. Click the dropdown next to your Workplace's name in the top-left corner.

2. From the resulting menu, select [Workplace settings] and open the [Integrations] section from the menu on the left.

3. In the [Version control] tab, select the [GitLab] option and click [Integrate].

4. Use the toggle at the top to [Enable GitLab branch creation]. You must now provide the following:

   • Your [GitLab group]. For more information on groups, see this GitLab help page.

   • The GitLab [Access token]. For more information on tokens, see this GitLab help page.

   • Optionally, you can provide the URL address of your server.

5. Once we verify these credentials, you can start adding GitLab repositories.

Some object types in Timebook include the [Git] property that links them to corresponding items in Bitbucket, GitHub, or GitLab. You can configure these objects to update their statuses automatically based on specific events in Git, like opening or merging a pull request.

For more information, see Team settings, and check which features include the dedicated [Automation] tab that allows you to set up this automated configuration.

Related articles

Workplace settings

Team settings