Skip to main content
Repositories in Gitflare contain all your project files and revision history. You can create both public and private repositories to organize your code.

​
Creating a new repository

1

Navigate to the new repository page

Click on your profile menu and select New Repository, or navigate directly to /new.
2

Enter repository details

Fill in the repository information:
  • Repository name: Enter a name for your repository (e.g., my-awesome-project)
    • Only letters, numbers, hyphens, and underscores are allowed
    • Name cannot end with .git
    • Maximum 100 characters
    • Spaces will automatically be converted to hyphens
  • Description (optional): Add a brief description of your project (up to 500 characters)
3

Choose visibility

Select the repository visibility:
  • Public: Anyone can see this repository
  • Private: Only you can see this repository
Private repositories require a Personal Access Token (PAT) for all git operations, including cloning.
4

Create the repository

Click the Create button to create your repository. You’ll be automatically redirected to your new repository page.

​
Repository name requirements

When creating a repository, your name must follow these rules:
  • Minimum 1 character, maximum 100 characters
  • Can only contain:
    • Letters (a-z, A-Z)
    • Numbers (0-9)
    • Hyphens (-)
    • Underscores (_)
  • Cannot end with .git
Repository names are automatically formatted as you type. Spaces are converted to hyphens, and invalid characters are removed.

​
Initial setup

After creating a repository, you’ll see instructions for pushing your code. There are two main approaches:

​
Creating a new repository on the command line

If you’re starting from scratch: 
echo "# my-repo" >> README.md
git init
git add README.md
git commit -m "first commit"
git branch -M main
git remote add origin https://your-domain.com/username/my-repo.git
git push -u origin main

​
Pushing an existing repository

If you already have a Git repository: 
git remote add origin https://your-domain.com/username/my-repo.git
git branch -M main
git push -u origin main
You’ll need a Personal Access Token to push changes. Create one in Settings > Personal Access Tokens.

​
Managing repository settings

You can update your repository settings at any time by navigating to the repository’s Settings tab.
1

Navigate to repository settings

Go to your repository and click on the Settings tab in the navigation menu.
2

Update repository details

You can modify:
  • Description: Update or add a description for your repository
  • Visibility: Change between public and private
The repository name cannot be changed after creation.
3

Save changes

Click Save changes to apply your updates. The button is only enabled when you’ve made changes.

​
Repository visibility

​
Public repositories

  • Anyone can view the repository contents
  • Visible in your profile’s repository list
  • Can be cloned without authentication
  • Requires a Personal Access Token for push operations

​
Private repositories

  • Only you can view the repository
  • Not visible to other users
  • Requires a Personal Access Token for all operations (clone, pull, push)
You can change repository visibility at any time in the repository settings.

​
Next steps

Git operations

Learn how to clone, push, and pull from your repositories

Managing issues

Track bugs and feature requests with issues

Build docs developers (and LLMs) love

Get started for freeTalk to us