AnyPlatform Workspace

The control center for the AnyPlatform ecosystem. This repository provides powerful tools to manage, deploy, and synchronize changes across all AnyPlatform repositories.

🎯 Purpose

• Repository Synchronization: Deploy files and folders across all repos with atomic commits
• Ecosystem Management: Create and manage all AnyPlatform packages
• Quality Control: Enforce uniform structure and standards
• Automated Workflows: Scripts for bulk operations with safety backups
• Developer Tools: Interactive menu system for all workspace operations

📦 Repository Structure

The AnyPlatform ecosystem consists of multiple independent GitHub repositories, organized locally for development:

Package Repositories (in /packages/ directory)

Each package is its own GitHub repository at github.com/anyplatform/[package-name]

Core Packages

• platform - Main CLI and coordination layer
• client - Client-side core functionality
• server - Server-side core functionality

Client Component Packages

• client.any.components - React/ShadcN UI component generators
• client.any.data - Zustand stores with calculated props and API integration
• client.any.auth - Authentication flows and components
• client.any.api - API client code with React Query integration
• client.any.obs - Observability and analytics code

Server Component Packages

• server.any.api - Fastify routes and API endpoints
• server.any.data - Database models, migrations, and queries
• server.any.auth - Authentication middleware and authorization
• server.any.services - Business logic services and domain models
• server.any.workflows - Automated workflows and background jobs
• server.any.obs - Server monitoring and logging

Management Repositories (at root level)

• platform.demo - Complete demo application
• platform.examples - Example projects and code snippets
• platform.workspace - This workspace management repository

🚀 Interactive Menu

Launch the workspace control center:

npm run menu
# or
npm run workspace

This provides an interactive menu for all workspace operations including deployment, package management, and development tasks.

📁 Structure

• package/ - Workspace tools (published to npm)
• scripts/ - Setup and management scripts
• templates/ - Templates for generating uniform packages
• docs/ - Ecosystem documentation
• quality/ - Quality standards and validation rules
• tests/ - Workspace tool tests
• storybook/ - Stories about the ecosystem itself

🛠️ Repository Management Tools

Core Deployment Scripts

workspace-commit-all.sh 🔒

Creates synchronized commits across all repositories with workspace action tracking.

• Forces commits with @anyplatform/workspace action prefix
• Ensures atomic operations across ecosystem
• Uses --allow-empty for consistency tracking

deploy-folder.sh 📁

Deploy entire folders with structure preservation.

• Maintains folder hierarchy in target repos
• Automatic backup commits before deployment
• Batch operations with progress tracking
• Makes shell scripts executable automatically

delete-from-repos.sh 🗑️

Safely remove files from multiple repositories.

• Automatic backup commits before deletion
• Batch deletion with rollback capability
• Dry-run mode for verification
• Detailed operation logging

deploy.sh 📦

Flexible file deployment across repositories.

• Deploy specific files to selected repos
• Supports --all, --packages, --docs shortcuts
• Auto-commit with custom messages
• Handles both sibling and package repos

Orchestration Scripts

deploy-all.sh

Full ecosystem deployment orchestration.

• Deploys common files to all repositories
• Deploys package-specific configurations
• Updates TypeScript configs per package type
• Handles client/server separation

workspace-menu.sh 🎮

Interactive control center for all operations.

• Visual menu system for deployments
• Package creation and management
• Development task shortcuts
• Repository status overview

Quick Actions

quick-deploy.sh

Rapid deployment for common configurations.

• Shortcuts: mcp, prettier, eslint, workflow, docs
• Pre-configured commit messages
• Single command updates

Package Creation

package_creator_tool.ts

Generate new packages with uniform structure.

• Complete package structure from templates
• All package types supported
• Storybook setup included
• Git initialization with proper remotes

🔐 Safety Features

All deployment and deletion operations include:

• Automatic backup commits before changes
• Workspace action tracking for audit trail
• Dry-run mode for preview
• Rollback capability through git history
• Atomic operations across all repos

📋 Package Standards

Every AnyPlatform package has identical structure:

• README.md - Generated from template
• anyplatform.yaml - Uniform contract
• package/entrypoint.ts - Standard entrypoint
• tests/ - Unit, integration, fixtures
• storybook/ - Even server packages get Storybook!
• docs/ - API documentation and examples

🔧 Common Operations

Deploy Hook Scripts to All Repos

./scripts/deploy-folder.sh -s "scripts" -d "scripts"

Remove Files from All Repos

./scripts/delete-from-repos.sh -f "old-file.txt,deprecated.js"

Deploy Configuration Updates

./scripts/deploy.sh --all  # Deploy all common files
./scripts/quick-deploy.sh mcp  # Quick deploy MCP config

Create Workspace-Wide Commit

./scripts/workspace-commit-all.sh "update dependencies"

💻 Development

npm install
npm run dev          # Watch mode
npm test             # Run tests
npm run storybook    # View ecosystem stories
npm run menu         # Launch interactive menu

📚 Documentation

• Setup Guide
• Package Contract
• Best Practices
• Architecture

---

The workspace is the living, breathing control center of AnyPlatform.