# 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

```bash
# 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

```bash
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/