Welcome to HUB

A Human × AI Creative Agency built on greater good creativity

---

What Is HUB?

HUB is where human creativity and AI capability meet to build things that matter.

We're not a tech company. We're not a consultancy. We're a creative agency that believes AI should amplify human potential, not replace it. We build:

• 🎨 Design systems that make brands unforgettable
• 🤖 AI strategies that actually work for real people
• 📖 Open learning resources for everyone
• 🌟 Multi-agent systems with personality and purpose
• 🏙️ Community storytelling platforms (like CurationsLA)
• 🌱 Youth empowerment programs (Youth Curator Movement)

Our philosophy: Greater good creativity. Every project, every framework, every line of code asks: Does this make the world better?

---

The Three Branches

HUB operates through three interconnected initiatives:

1. HUB (The Creative Agency)

Human × AI collaboration for design, content, research, and AI strategy. We work with brands, communities, and creators to build things that matter.

🌐 hub.curations.org

What we do:

• AI strategy and implementation
• Design systems and brand architecture
• Multi-agent system development
• Content and creative direction
• Open-source framework development

How we work:

• Ethical, transparent, community-centered
• Non-political, focused on good
• Open learning and documentation
• AI personas ("Curators") with specialized expertise

Learn more about HUB → | Explore Services →

2. CurationsLA (Hyperlocal Media)

A sister project demonstrating Human × AI collaboration in action. CurationsLA is a hyperlocal LA media platform that's:

• Free and ungated
• Community-focused storytelling
• Good vibes only, non-political
• Human-curated with AI support
• A living example of ethical AI in civic media

🏙️ la.curations.cc

Learn more about CurationsLA →

3. Youth Curator Movement (Educational Empowerment)

A mission-driven initiative to empower young people with AI literacy, creativity, and digital wellbeing.

Not a bootcamp. Not a course. A movement.

We teach youth to:

• Use AI as a creative medium
• Understand emotional and digital safety
• Tell their community's stories
• Become future digital stewards
• Build with purpose, not hype

100% free. 100% open-source. 100% focused on empowerment.

Learn more about the Youth Curator Movement →

---

Who This Is For

🎨 Creators & Brands Want to build with AI in ethical, creative ways? We share our frameworks, design systems, and strategies openly.

🌱 Young People & Educators Looking for healthy, empowering AI education? The Youth Curator Movement is built for you.

💻 Developers & AI Practitioners Need real-world frameworks and technical architecture? Our cookbook and documentation are fully open.

🏘️ Communities & Storytellers Want to see Human × AI collaboration in action? CurationsLA shows what's possible.

---

What You'll Find Here

This hub (hub.curations.org) is our source of truth and community learning space. Everything we build, we document openly:

📚 The AI × Human Cookbook

10 comprehensive frameworks covering:

• AI agent development (foundations → production)
• Advanced prompting techniques
• Branding and discovery strategies
• Real-world implementation playbooks

Explore the Cookbook →

🎨 Design Systems

Our visual identity, brand language, and design philosophy - all documented and open.

View Design Systems →

🤖 The Curators (AI Personas)

Meet the specialized AI personas that power VibeHub - each with unique expertise and personality.

Meet the Curators →

🏗️ Technical Architecture

How we build: multi-agent systems, collaboration protocols, and our technical philosophy.

Explore Architecture →

---

Our Values

✅ Open Learning

All tools, guides, frameworks, and playbooks are free and ungated. Knowledge should be accessible.

✅ Greater Good Creativity

Every project asks: Does this make the world better? If not, we don't build it.

✅ Human × AI Partnership

AI amplifies human creativity. It doesn't replace it. We build systems where both thrive.

✅ Emotional Safety

AI should support human wellbeing, not manipulate or extract. We prioritize healthy relationships with technology.

✅ Community-Centered

We serve communities, not corporations. Good vibes, non-political, focused on uplifting people.

✅ Transparency

How we work, what we build, and why we build it - all documented in the open.

---

Start Exploring

Choose your path:

🌱 New to AI? Start with the Youth Curator Movement or Cookbook Foundations

🎨 Creator or Brand? Check out our Design Systems and Branding Frameworks

💻 Developer or Engineer? Dive into Technical Architecture and Advanced Prompting

🏘️ Community Builder? See CurationsLA and How to Collaborate

🔍 Just Exploring? Browse the full site map or use GitBook's AI to find what you need

---

Hidden Layers

VibeHub is built in layers. The more you explore, the more you'll discover.

Some things are obvious. Some things are hidden.

Some prompts are for beginners. Some are for the 0.1%.

Keep exploring. 🗺️

---

Get Involved

VibeHub is a living collaboration. Here's how you can participate:

• Learn: All our resources are free and open
• Contribute: See something to improve? We welcome contributions
• Collaborate: Working on something aligned with our mission? Let's talk
• Share: Know someone who'd benefit from this? Pass it along

How to Contribute & Collaborate →

---

📖 About This Documentation

This documentation is built with Astro and Starlight, a modern static site generator for building fast, accessible documentation sites. It's hosted on GitHub Pages for easy access and collaboration.

For Repository Maintainers:

• 🚀 Astro Documentation - Learn more about Astro
• 🌟 Starlight Documentation - Starlight features and configuration
• 📦 Package.json - Project dependencies and build scripts

For Contributors:

• All documentation is written in Markdown/MDX
• Documentation files are in src/content/docs/
• See How to Contribute for guidelines
• Changes to the main branch automatically rebuild and deploy the site using Astro

Local Development:

npm install          # Install dependencies
npm run dev         # Start development server
npm run build       # Build for production

---

📋 Docs-as-Code

This repository implements a Docs-as-Code workflow for managing OpenAPI specifications. API documentation is treated as code: version-controlled, automatically validated, and integrated into the development workflow.

What is Docs-as-Code?

Docs-as-Code is a methodology where documentation is:

• Version-controlled alongside code using Git
• Automatically validated through CI/CD pipelines
• Reviewed through pull requests like any other code change
• Published automatically when changes are merged

OpenAPI Specification Management

All OpenAPI specifications are stored in the specs/ directory. When you add or modify OpenAPI files (.yaml, .yml, or .json), our automated workflow:

1. Validates the specification against OpenAPI standards
2. Analyzes changes and comments on pull requests
3. Documents what endpoints or schemas have changed
4. Optionally uploads to external services for SDK generation

How to Use

Adding a new API specification:

1. Create your OpenAPI spec file in the specs/ directory
2. Follow the OpenAPI 3.0+ specification
3. Commit and push your changes
4. The workflow automatically validates your specification

Updating an existing specification:

1. Edit the OpenAPI file in specs/
2. Create a pull request with your changes
3. Review the automated validation results and change summary
4. Merge when approved

Directory structure:

specs/
├── README.md           # Guidelines for OpenAPI specs
└── example-api.yaml    # Example specification (replace with your own)

Workflow Features

• ✅ Automatic validation using industry-standard OpenAPI validators
• 📊 Change detection on pull requests with detailed summaries
• 🔄 Integration ready with Stainless API for SDK generation
• 🚀 Zero configuration - works out of the box for basic validation

Optional: SDK Generation

The workflow includes optional integration with Stainless for automatic SDK generation. To enable:

1. Create a Stainless account and project
2. Configure authentication (GitHub OIDC or API key)
3. Uncomment the upload-to-stainless job in .github/workflows/openapi-spec-workflow.yml
4. Update with your project details

See specs/README.md for detailed documentation.

Workflow Configuration

The Docs-as-Code workflow is defined in .github/workflows/openapi-spec-workflow.yml and includes:

• Validation job: Checks OpenAPI specs for correctness
• Documentation job: Comments on PRs with change summaries
• Optional upload job: Sends specs to external services (commented out by default)

Triggering the workflow:

• Automatically on push to main branch (for files in specs/)
• Automatically on pull requests (for files in specs/)
• Manually via GitHub Actions UI

---

🎨 Repository Origins and Enhancements

From Mintlify to HUB

This repository represents a thoughtful evolution of documentation infrastructure, combining best practices from modern documentation platforms with CURATIONS' minimalistic and professional design philosophy.

Original Inspiration: The mintlify/starter repository provided inspiration for creating beautiful, developer-friendly documentation. Mintlify offers excellent documentation features, but we chose to build on Astro + Starlight for greater flexibility and control over our documentation experience.

Why Astro + Starlight?

Instead of forking Mintlify directly, we built HUB's documentation platform using:

• Astro: A modern static site generator focused on performance
• Starlight: Astro's documentation theme with built-in best practices
• Custom CURATIONS Branding: Minimalistic, professional design aligned with our agency's visual identity

This approach gives us:

• ⚡ Lightning-fast performance with minimal JavaScript
• 🎨 Complete design control with custom CSS and components
• 📝 Markdown/MDX content for easy contribution
• 🔍 Built-in search powered by Pagefind
• 📱 Responsive design that works on all devices
• ♿ Accessibility-first approach

HUB Branding

The rebrand from the original concept to HUB includes:

• Visual Identity: Left-aligned "HUB" title with "BY CURATIONS" subtitle
• Professional Aesthetic: Minimalistic design with thoughtful color palette
• Consistent Naming: All references updated across documentation and code
• CURATIONS Integration: Clear connection to the CURATIONS ecosystem

Enhanced with Best-in-Class Tools

HUB leverages modern development tools already integrated in this repository:

1. Astro + Starlight Documentation

   • Modern, fast, accessible documentation platform
   • Built-in search, navigation, and responsive design
   • Custom styling for HUB branding

2. Docs-as-Code Workflow (OpenAPI Specifications)

   • Automatic validation of API specifications
   • Version control for all documentation
   • Integration with Stainless for SDK generation
   • See specs/README.md for details

3. GitHub Pages Deployment

   • Automated builds and deployments via GitHub Actions
   • Fast, reliable hosting at no cost
   • Custom domain support (hub.curations.org)

4. GitBook Integration (Optional)

   • Alternative documentation platform support
   • See GITBOOK_INTEGRATION.md for setup

Documentation Structure

ai-learning/
├── src/
│   ├── content/
│   │   └── docs/          # All documentation content
│   │       ├── about-hub.md
│   │       ├── cookbooks/ # AI development frameworks
│   │       └── ...
│   └── styles/
│       └── custom.css     # HUB branding styles
├── specs/                 # OpenAPI specifications
├── astro.config.mjs       # Astro configuration
└── package.json           # Dependencies and scripts

Local Development

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

Contributing

All documentation is written in Markdown/MDX and lives in src/content/docs/. To contribute:

1. Edit or create .md files in src/content/docs/
2. Follow existing documentation style and structure
3. Test locally with npm run dev
4. Submit a pull request

See How to Contribute for detailed guidelines.

Deployment

The site is automatically deployed to GitHub Pages when changes are pushed to the main branch:

• Live Site: https://hub.curations.org/
• Build Status: Check the badge at the top of this README
• Deployment Time: ~2-3 minutes from push to live

For detailed deployment setup and troubleshooting, see DEPLOYMENT.md.

---

Contact

HUB Human × AI Creative Agency Los Angeles, CA

Questions? Ideas? Collaborations? Reach out through our Get Involved page.

---

"The future is built by those who believe in the beauty of greater good creativity."

Welcome to HUB. ✨