Development Hub

Central orchestration project for managing Rob's multi-project development ecosystem.

Overview

Development Hub provides tooling to create and manage projects that follow consistent patterns:

• Centralized documentation via Docusaurus
• Gitea repository hosting with Pages support
• AI-assistant context files (CLAUDE.md)
• Python project structure

Quick Start

Create a New Project

# Add to PATH (one-time)
export PATH="$PATH:$HOME/PycharmProjects/development-hub/bin"

# Create a new project
new-project my-awesome-tool --title "My Awesome Tool" --tagline "Does awesome things"

This will:

1. Create a Gitea repository at gitea.brrd.tech/rob/my-awesome-tool
2. Set up local project at ~/PycharmProjects/my-awesome-tool/
3. Generate starter files (CLAUDE.md, README.md, pyproject.toml, .gitignore)
4. Configure documentation symlink and build scripts
5. Create initial commit and push

View Full Options

new-project --help

What Gets Created

For each new project:

~/PycharmProjects/my-project/
├── src/my_project/        # (you create this)
├── tests/                 # (you create this)
├── docs/                  # Symlink to centralized docs
├── CLAUDE.md              # AI assistant context
├── README.md              # Project readme
├── pyproject.toml         # Python packaging
└── .gitignore             # Standard Python ignores

Documentation System

All projects use centralized documentation:

• Private hub: ~/PycharmProjects/project-docs/ (view with npm start)
• Public sites: https://pages.brrd.tech/rob/{project}/

The docs/ symlink in each project points to its section in project-docs.

Configuration

Gitea Token

The script needs a Gitea API token. It will prompt you the first time and save it to ~/.config/development-hub/gitea-token.

To create manually:

1. Go to https://gitea.brrd.tech/user/settings/applications
2. Generate token with 'repo' scope
3. Set GITEA_TOKEN env var or let the script save it

Full Documentation

https://pages.brrd.tech/rob/development-hub/