Implement automated GitHub Pages deployment with dynamic date replacement for JSONL URLs

[Copilot]

This PR implements a complete automated GitHub Pages deployment system with dynamic date replacement functionality for JSONL file URLs, addressing all requirements in the issue.

Key Features Implemented

🚀 Automated GitHub Pages Deployment

• Created a robust deploy-pages.yml workflow that deploys content from the public/ directory
• Configured proper permissions (pages: write, id-token: write) and environment settings
• Added concurrency control to prevent overlapping deployments

📅 Dynamic Date Replacement System

The workflow includes sophisticated date replacement logic using sed to process files during build:

# Replace YYYY-MM-DD with current date in all relevant files
find _build -name "*.html" -type f -exec sed -i "s/YYYY-MM-DD/$TODAY/g" {} \;
find _build -name "*.js" -type f -exec sed -i "s/YYYY-MM-DD/$TODAY/g" {} \;
find _build -name "*.json" -type f -exec sed -i "s/YYYY-MM-DD/$TODAY/g" {} \;

🔄 Multiple Deployment Triggers

• Push to main: Automatic deployment on code changes
• Daily schedule: Runs at 00:01 UTC to keep date links current
• Manual dispatch: Allows on-demand deployments

📱 Client-Side Fallback

Added JavaScript fallback in public/index.html for immediate date updates:

// Client-side date replacement as fallback
const today = new Date();
const dateStr = today.getFullYear() + '-' + 
               String(today.getMonth() + 1).padStart(2, '0') + '-' + 
               String(today.getDate()).padStart(2, '0');

if (link.href.includes('YYYY-MM-DD')) {
  link.href = link.href.replace('YYYY-MM-DD', dateStr);
  link.textContent = dateStr + '.jsonl';
}

Repository Structure Improvements

🧹 Cleanup and Organization

• Removed duplicate files: Eliminated redundant root index.html and duplicate deploy.yml workflow
• Proper file organization: All GitHub Pages content now properly organized in public/ directory
• Build artifact management: Enhanced .gitignore for proper build artifact handling

📖 Comprehensive Documentation

• Enhanced README.md: Added features overview, quick start guide, and usage examples
• Detailed DEPLOYMENT.md: Comprehensive guide including:
  • iPhone file upload troubleshooting
  • CORS and performance considerations
  • Testing and validation procedures
  • Security best practices

Usage Example

The system automatically converts date placeholders in your files:

<!-- Before deployment -->
<a href="https://example.com/data/YYYY-MM-DD.jsonl">Today's Data</a>

<!-- After deployment (assuming today is 2025-09-22) -->
<a href="https://example.com/data/2025-09-22.jsonl">Today's Data</a>

Testing Results

• ✅ YAML syntax validation passed
• ✅ Date replacement functionality verified (YYYY-MM-DD → 2025-09-22)
• ✅ Local deployment testing successful
• ✅ Client-side fallback working correctly

The screenshot shows the final implementation working correctly, with the JSONL link displaying the current date (2025-09-22.jsonl) instead of the placeholder template.

Benefits

• Zero maintenance: Daily automated updates ensure date links stay current
• Mobile-friendly: Optimized for external device file uploads with detailed iPhone troubleshooting
• Robust deployment: Concurrency control and proper error handling
• Developer-friendly: Clear documentation and examples for easy adoption

The repository is now ready for GitHub Pages with automated daily deployment and dynamic JSONL file URL generation based on the current date.

This pull request was created as a result of the following prompt from Copilot chat.

Implement an automated GitHub Pages deployment workflow with dynamic date replacement for JSONL file URLs. This involves:

1. Repository Structure Setup:

   • Create a 'public' directory for GitHub Pages content.
   • Move existing 'index.html' to 'public/'.
   • Create a '.github/workflows' directory.
   • Add a '.gitignore' for build artifacts.

2. GitHub Actions Workflow:

   • Create a workflow file 'deploy-pages.yml' to deploy from 'public/'.
   • Configure deployment to GitHub Pages via Actions.
   • Implement dynamic date replacement for 'YYYY-MM-DD' placeholders in JSONL URLs (in HTML, JS, JSON, etc) using 'sed'.
   • Set permissions and environment for deployment.
   • Add a daily schedule (00:01 UTC), push, and manual triggers.
   • Add concurrency control to avoid overlapping runs.

3. Dynamic Date Handling:

   • Template system for JSONL URLs with 'YYYY-MM-DD' placeholder.
   • Date replacement logic using shell (sed) in workflow.
   • Client-side JavaScript fallback for date replacement (in case server-side fails or for immediate updates).

4. Documentation and Validation:

   • Update README.md with upload/decoding process, troubleshooting for iPhone uploads, CORS/file size/performance notes, usage examples, and architecture.

5. Testing:

   • Validate workflow syntax, deployment, date replacement, and accessibility.

The result should be a repo ready for GitHub Pages with automated daily deployment and dynamic JSONL file URL generation based on the current date.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[TheAVCfiles]

YAY