77 lines
2.1 KiB
Markdown
77 lines
2.1 KiB
Markdown
# 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/
|