gitlab-org--gitlab-foss/doc/user/project/index.md

stage	group	info	type
Create	Source Code	To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments	reference

Projects (FREE)

In GitLab, you can create projects to host your codebase. You can also use projects to track issues, plan work, collaborate on code, and continuously build, test, and use built-in CI/CD to deploy your app.

Projects can be available publicly, internally, or privately. GitLab does not limit the number of private projects you can create.

Project features

Projects include the following features:

Repositories:

• Issue tracker: Discuss implementations with your team.
  • Issue Boards: Organize and prioritize your workflow.
  • Multiple Issue Boards: Create team-specific workflows (Issue Boards) for a project.
• Repositories: Host your code in a fully-integrated platform.
  • Branches: Use Git branching strategies to collaborate on code.
  • Protected branches: Prevent collaborators from changing history or pushing code without review.
  • Protected tags: Control who has permission to create tags and prevent accidental updates or deletions.
  • Repository mirroring
  • Signing commits: Use GNU Privacy Guard (GPG) to sign your commits.
  • Deploy tokens: Manage access to the repository and Container Registry.
• Web IDE
• CVE ID Requests: Request a CVE identifier to track a vulnerability in your project.

Issues and merge requests:

• Issue tracker: Discuss implementations with your team.
  • Issue Boards: Organize and prioritize your workflow.
  • Multiple Issue Boards: Create team-specific workflows (Issue Boards) for a project.
• Merge Requests: Apply a branching strategy and get reviewed by your team.
  • Merge Request Approvals: Ask for approval before implementing a change.
  • Fix merge conflicts from the UI: View Git diffs from the GitLab UI.
  • Review Apps: By branch, preview the results of the changes proposed in a merge request.
• Labels: Organize issues and merge requests by labels.
• Time Tracking: Track time estimated and spent on issues and merge requests.
• Milestones: Work toward a target date.
• Description templates: Define context-specific templates for issue and merge request description fields.
• Slash commands (quick actions): Create text shortcuts for common actions.
• Autocomplete characters: Autocomplete references to users, groups, issues, merge requests, and other GitLab elements.
• Web IDE

GitLab CI/CD:

• GitLab CI/CD: Use the built-in Continuous Integration, Delivery, and Deployment tool.
  • Container Registry: Build and push Docker images.
  • Auto Deploy: Configure GitLab CI/CD to automatically set up your app's deployment.
  • Enable and disable GitLab CI/CD
  • Pipelines: Configure and visualize your GitLab CI/CD pipelines from the UI.
    • Scheduled Pipelines: Schedule a pipeline to start at a chosen time.
    • Pipeline Graphs: View your pipeline from the UI.
    • Job artifacts: Define, browse, and download job artifacts.
    • Pipeline settings: Set up Git strategy (how jobs fetch your repository), timeout (the maximum amount of time a job can run), custom path for .gitlab-ci.yml, test coverage parsing, pipeline visibility, and more.
  • Kubernetes cluster integration: Connect your GitLab project with a Kubernetes cluster.
  • Feature Flags: Ship different features by dynamically toggling functionality. (PREMIUM)
• GitLab Pages: Build, test, and deploy your static website.

Other features:

• Wiki: Document your GitLab project in an integrated Wiki.
• Snippets: Store, share and collaborate on code snippets.
• Value Stream Analytics: Review your development lifecycle.
• Insights: Configure the insights that matter for your projects. (ULTIMATE)
• Security Dashboard (ULTIMATE)
• Syntax highlighting: Customize your code blocks, overriding the default language choice.
• Badges: Add an image to the project overview.
• Releases: Take a snapshot of the source, build output, metadata, and artifacts associated with a released version of your code.
• Package Registry: Publish and install packages.
• Code owners: Specify code owners for specific files.
• License Compliance: Approve and deny licenses for projects. (ULTIMATE)
• Dependency List: View project dependencies. (ULTIMATE)
• Requirements: Create criteria to check your products against. (ULTIMATE)
• Static Site Editor: Edit content on static websites without prior knowledge of the codebase or Git commands.
• Code Intelligence: Navigate code.

Project integrations

Integrate your project with Jira, Mattermost, Kubernetes, Slack, and a lot more.

Import or export a project

• Import a project from:
  • GitHub to GitLab
  • Bitbucket to GitLab
  • Gitea to GitLab
  • FogBugz to GitLab
• Export a project from GitLab
• Importing and exporting projects between GitLab instances

GitLab Workflow - VS Code extension

To avoid switching from the GitLab UI and VS Code while working in GitLab repositories, you can integrate the VS Code editor with GitLab through the GitLab Workflow extension.

To review or contribute to the extension's code, visit its codebase in GitLab.

Project APIs

There are numerous APIs to use with your projects:

• Badges
• Clusters
• Threads
• General
• Import/export
• Issue Board
• Labels
• Markdown
• Merge Requests
• Milestones
• Services
• Snippets
• Templates
• Traffic
• Variables
• Aliases
• Analytics

Project activity analytics overview (ULTIMATE SELF)

Introduced in GitLab Ultimate 13.7 as a Beta feature.

Project details include the following analytics:

• Deployment Frequency

For more information, see Project Analytics API.