Skip to content

Add GitHub Pages deployment and update amenities images#1

Merged
kvnloo merged 5 commits intomainfrom
dev
Nov 21, 2025
Merged

Add GitHub Pages deployment and update amenities images#1
kvnloo merged 5 commits intomainfrom
dev

Conversation

@kvnloo
Copy link
Owner

@kvnloo kvnloo commented Nov 21, 2025

Summary

  • ✅ Add GitHub Actions workflow for automated deployment to GitHub Pages
  • ✅ Configure dual-branch deployment strategy (main → /, dev → /dev/)
  • ✅ Update amenities page images with better descriptive content
  • ✅ Add comprehensive deployment documentation

Changes

GitHub Actions Workflow

  • Created .github/workflows/deploy.yml for automated deployments
  • Builds both main and dev branches on every push to either branch
  • Deploys main to root path and dev to /dev/ subdirectory
  • Single combined artifact ensures both sites are always available

Configuration Updates

  • Updated vite.config.ts to support dynamic base paths
  • Uses VITE_BASE_PATH environment variable for build-time path configuration
  • Maintains backward compatibility with default root path

Amenities Page Enhancements

  • Updated Vertical Grass Lab image reference to show autonomous robots
  • Updated Multi-Sport Ecosystem image to show biomechanics HUD overlay
  • Improved alt text for better accessibility

Documentation

  • Added .github/DEPLOYMENT.md with:
    • Complete setup instructions for GitHub Pages
    • Troubleshooting guide
    • Local testing commands
    • URL reference for deployed sites

Testing Checklist

  • Enable GitHub Pages in repository settings (Settings → Pages → Source: GitHub Actions)
  • Verify workflow runs successfully after merge
  • Check production site loads at https://kvnloo.github.io/ace/
  • Check dev site loads at https://kvnloo.github.io/ace/dev/

Deployment URLs

After merging and enabling GitHub Pages:

🤖 Generated with Claude Code

kvnloo and others added 2 commits November 20, 2025 21:30
- Add GitHub Actions workflow for automated deployment to GitHub Pages
- Configure dual-branch deployment: main (/) and dev (/dev/)
- Update vite.config.ts to support dynamic base paths via VITE_BASE_PATH
- Add deployment documentation with setup and troubleshooting guides
- Update amenities page with new images:
  - Vertical farm with autonomous robots for Grass Lab section
  - Tennis court with biomechanics HUD for Multi-Sport Ecosystem section
- Improve image alt text for better accessibility

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Remove npm cache configuration that requires lock file
- Change from npm ci to npm install for more flexible dependency resolution
- Add .gitignore to exclude node_modules and build artifacts
- Add package-lock.json for reproducible builds and faster CI installs

This fixes the deployment workflow error: "Dependencies lock file is not found"

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Add modern, professional README structure with emojis and clear sections
- Include complete facility layout and technology stack details
- Document development setup, deployment process, and project architecture
- Add links to live demo, dev preview, and deployment guide
- Integrate information from project requirements document
- Include strategic goals, partnerships, and technical specifications
- Add project structure diagram and configuration examples
- Maintain all original technical details from requirements

This creates a developer-friendly, investor-ready README that clearly
communicates the project's vision, technology, and value proposition.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Remove non-existent /index.css link from index.html that was breaking dev build
- Add clean step in workflow to ensure fresh build for dev branch
- This fixes the blank page issue on https://kvnloo.github.io/ace/dev/

Root cause: The index.html referenced /index.css which doesn't exist.
During build with VITE_BASE_PATH=/dev/, Vite couldn't resolve this path
correctly, causing the dev deployment to fail silently with a blank page.

Solution: Remove the unused CSS link since all styles are inline or
handled by Tailwind CDN.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
ROOT CAUSE: GitHub Pages serves the repo at /ace/, not at domain root.
The base paths were incorrectly set to / and /dev/ instead of /ace/ and /ace/dev/.

This caused:
- Main: Scripts loading from /assets/ instead of /ace/assets/
- Dev: Scripts loading from /dev/assets/ instead of /ace/dev/assets/
- Result: 404 errors, blank pages

CHANGES:
- Update main build: VITE_BASE_PATH='/ace/' (was '/')
- Update dev build: VITE_BASE_PATH='/ace/dev/' (was '/dev/')

This ensures Vite generates correct absolute paths:
- Main: /ace/assets/index-xxx.js ✅
- Dev: /ace/dev/assets/index-xxx.js ✅

After deployment, pages will load correctly:
- https://kvnloo.github.io/ace/ (main)
- https://kvnloo.github.io/ace/dev/ (dev)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@kvnloo kvnloo merged commit d74e487 into main Nov 21, 2025
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant