swadhin / opencodehub-docs public
/ opencodehub-docs / src / content / docs / getting-started / first-repository.md
swadhinbiswas fix: remove highlight.js CSS import causing Docker build failure · 7/21/2026
eeb5038
110 lines · 2.7 KB
Raw Download

title: "Create Your First Repository"

This guide walks you through the complete lifecycle of a repository in OpenCodeHub.

Step 1: Create the Repository

  1. Click the + button in the top navbar → New Repository
  2. Owner: Select yourself or an organization
  3. Repository Name: Enter hello-world
  4. Description: "My first project on OpenCodeHub"
  5. Visibility: Select Public
  6. Initialize: Check Initialize with README

Click Create Repository.

Step 2: Clone

SSH (Recommended)

Add your SSH key in Settings → SSH Keys first.

git clone ssh://git@your-server:2222/username/hello-world.git

HTTPS

git clone https://git.yourcompany.com/username/hello-world.git

For HTTPS, you'll need a Personal Access Token. Generate one at Settings → Tokens.

Step 3: Make Changes

cd hello-world

# Edit files
echo "# Hello World\n\nThis is my first change!" > README.md

# Commit
git add README.md
git commit -m "Update README"

Step 4: Push

git push origin main

Refresh the repository page to see your changes.

Step 5: Create a Pull Request

  1. Create a feature branch:
git checkout -b feat/add-feature
  1. Make changes and push:
echo "New feature" > feature.txt
git add feature.txt
git commit -m "Add new feature"
git push -u origin feat/add-feature
  1. In the web UI, go to Pull Requests → New Pull Request
  2. Select feat/add-feature as source, main as target
  3. Add a title and description
  4. Click Create Pull Request

Step 6: Review and Merge

  1. Add reviewers on the PR page
  2. Reviewers can approve or request changes
  3. Once approved, click Merge or add to the Merge Queue

Step 7: Explore Features

Wiki

Go to the Wiki tab to create documentation for your project.

Issues

Go to Issues → New Issue to track bugs and feature requests.

Projects

Go to Projects to create a kanban board for task management.

Actions

Go to Actions to view CI/CD pipeline runs. Create .github/workflows/*.yml files to set up automated builds.

Settings

Go to Settings to configure:

  • Branch Protection — Require reviews, status checks
  • Collaborators — Add team members
  • Webhooks — Integrations with external services
  • Deploy Keys — SSH keys for automated deployments

Next Steps

  • Stacked PRs — Break large changes into reviewable stacks
  • AI Code Review — Get automated code feedback
  • CI/CD — Set up automated pipelines
  • CLI — Manage everything from the terminal