diff --git a/repositoy_platform_overview.md b/repositoy_platform_overview.md new file mode 100644 index 0000000..63d2c12 --- /dev/null +++ b/repositoy_platform_overview.md @@ -0,0 +1,54 @@ +# Repository Platform Overview + +This document defines our strategy for hosting, organizing, and managing repositories for Gluebox.com LLC projects. + +We intentionally split public-facing, ecosystem-integrated projects from internal, private platform code to balance discoverability, collaboration, and company control. + +--- + +## ✅ GitLab (Public / Ecosystem-Facing Repos) + +**Purpose:** +Public, ecosystem-facing Drupal projects intended for maximum discoverability, contribution, and integration with Packagist and the Drupal.org ecosystem. + +### Repositories + +- **RSVP-System-Recipes** + - Documentation, configuration, install guides for the RSVP System Drupal recipe + - Includes calendar integration, scheduling content types, ECA automation rules + - Clear, user-friendly recipe approach for site builders + +- **RSVP-System-Module** + - Custom Drupal module code + - PHP, Composer.json + - Packagist-ready + - Clean, reusable code for developer integration + +--- + +## ✅ Self-hosted Gitea (code.gluebox.com) (Private / Controlled Repos) + +**Purpose:** +Private/internal platform code and branded tools that remain under company control. Allows unlimited private repos with fine-grained access management. + +### Repositories + +- **Gluebox-Node** + - Installer scripts and system management tools for the Gluebox Node appliance + - Deployment automation + +- **RSVP-Theme** + - Radix-based Drupal theme customized for events and RSVP branding + - Branding assets + +- **Platform-Tools** + - Private CLI tools, packaging scripts, internal automation + - Helper utilities for company operations + +--- + +## ✅ Notes + +- Public-facing repos support **Drupal community integration** and **Packagist distribution**, boosting discoverability and open source collaboration. +- Private repos maintain **company control** over platform deployment, theming, and internal tooling. +- This split allows clear separation of concerns while keeping internal IP protected and brand-aligned.