GitHub to Calcs Builder Workflow for Diagrams

# Install Homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install npm via Homebrew
brew install npm

# Clone the specific diagram repository
git clone https://github.com/ClearCalcs/[repository-name]

# Navigate to repository
cd [repository-name]

# Pull latest changes
git pull

# Navigate to the appropriate folder:
cd /static      # For static diagrams
# OR
cd /interactive # For interactive diagrams

# For repositories with multiple diagrams:
cd solar/static              # Example: MAFI solar diagrams
cd bracket-checker/static    # Example: MAFI bracket diagrams

# Install required packages
npm install

# Ensure you're in the correct repository
pwd

# Pull latest changes
git pull

# Navigate to diagram folder
cd /static  # or /interactive

# Update packages
npm install

# Compile the diagram
npm run-script compile

# Files to upload:
# - Static: dist/compiled.js
# - Interactive: output/index.html

# Upload process:
# 1. Open Calcs.com template builder
# 2. Navigate to diagram widget
# 3. Upload the compiled file(s)
# 4. Update calculator

diagram-repo/
├── src/
│   ├── static/
│   │   ├── render.ts
│   │   └── package.json
│   └── interactive/
│       ├── interface.ts
│       └── package.json
├── dist/
└── output/

mafi-diagrams/
├── solar/
│   ├── static/
│   │   ├── package.json
│   │   └── src/
│   └── interactive/
│       ├── package.json
│       └── src/
├── bracket-checker/
│   ├── static/
│   │   ├── package.json
│   │   └── src/
│   └── interactive/
│       ├── package.json
│       └── src/
└── shared/
    └── components/

# Always start with latest code
git pull

# Create feature branches for major changes
git checkout -b feature/new-diagram-type

# Commit regularly with descriptive messages
git commit -m "Add parameter validation for tube dimensions"

# Push changes for review
git push origin feature/new-diagram-type

# Check for outdated packages
npm outdated

# Update specific package
npm update [package-name]

# Install new dependency
npm install [package-name] --save

# Run compilation with verbose output
npm run-script compile --verbose

# Check for detailed error messages
npm run-script compile 2>&1 | tee compile.log