GitHub Integration & CI/CD
Relevant source files
The following files were used as context for generating this wiki page:
The GitHub integration for WIREDUP serves as the central orchestration point for version control and automated deployment. It manages a multi-language codebase consisting of a Python AI Auto-Wiring system, a Rust-based terminal (NexTerm), and a web-based landing page interface. By connecting the GitHub repository to external edge platforms like Cloudflare Pages, the project achieves a streamlined CI/CD pipeline where code changes in the repository trigger immediate, atomic updates to the live environment.
The system is designed for high availability and ease of contribution, providing multiple authentication paths (GitHub CLI, Personal Access Tokens, and SSH) to ensure developers can sync their local environments with the remote repository at `https://github.com/RemyLoveLogicAI/WIREDUP%60.
Sources: DEPLOYMENT_STATUS.md:6-14, QUICKSTART.md:5-10, GITHUB_PUSH.md:3-8
GitHub Repository Structure & Management
The repository is configured as the authoritative source for all WIREDUP components. It maintains the full commit history, branching logic (primarily using the main branch), and integrated documentation.
Repository Composition
The repository hosts four primary categories of assets:
- Python AI System: 27 files constituting the core auto-wiring engine.
- Rust Terminal (NexTerm): 25 files for the TUI and terminal logic.
- Web Interface: Static assets located in the
/publicdirectory. - Documentation: Technical guides including
AGENT.mdandSKILLS.md.
Sources: DEPLOYMENT_STATUS.md:16-56, QUICKSTART.md:31-64, GITHUB_PUSH.md:61-71
Workflow Diagram
The following diagram illustrates the flow from local development to the GitHub remote repository.
Sources: GITHUB_PUSH.md:10-58
Authentication & Push Protocols
The project supports four distinct methods for pushing code to GitHub, catering to different security requirements and developer environments.
Authentication Methods
| Method | Tooling | Required Credentials | Recommendation |
|---|---|---|---|
| GitHub CLI | gh | Browser-based or token login | Recommended for Linux/macOS |
| Personal Access Token | git HTTPS | Classic Token with repo scope | Quickest setup |
| SSH | ssh-keygen | Ed25519 Public/Private Key | Best for automated systems |
| Manual Remote Set | git remote | Username + PAT | Troubleshooting fallback |
Sources: GITHUB_PUSH.md:10-60
Token Configuration
When using Personal Access Tokens (PAT), the token must be configured with the specific repo scope to allow full repository permissions. Traditional passwords are not supported for Git HTTPS operations.
Sources: GITHUB_PUSH.md:20-33
CI/CD and Cloudflare Pages Integration
The CI/CD pipeline is established through a webhook-based connection between GitHub and Cloudflare Pages. This integration enables "Push-to-Deploy" functionality, where the main branch acts as the production trigger.
Automated Deployment Flow
Deployment Configuration Settings
The CI/CD pipeline requires specific build parameters to correctly identify and deploy the web interface from the monorepo structure.
- Production Branch:
main - Build Command: None (Static site)
- Build Output Directory:
public - Root Directory: Repository root
Sources: DEPLOYMENT.md:16-20, CLOUDFLARE_DEPLOY.md:19-24, QUICKSTART.md:24-30
Monitoring and Maintenance
The GitHub integration provides several tools for monitoring the health and status of the CI/CD pipeline.
- Deployment Status: Tracked via
DEPLOYMENT_STATUS.md, which logs completed tasks, pending actions, and project statistics. - Preview URLs: Pull requests automatically generate unique preview URLs, allowing for testing changes before merging into
main. - Rollback Capability: The Cloudflare dashboard allows for instant rollbacks to any previous successful deployment recorded in the GitHub history.
Sources: DEPLOYMENT_STATUS.md:1-5, QUICKSTART.md:105-115, CLOUDFLARE_DEPLOY.md:92-100
Project Statistics (Current)
| Metric | Value |
|---|---|
| Total Commits | 5-6 (Status: Fully Synced) |
| Repository Size | ~1.5 MB |
| Total Code Lines | 7,570+ |
| Build Time | < 1 minute |
Sources: DEPLOYMENT_STATUS.md:103-110, QUICKSTART.md:120-130, CLOUDFLARE_DEPLOY.md:79-85
Conclusion
GitHub Integration & CI/CD within WIREDUP provides a robust framework for managing the project's complex multi-component architecture. By leveraging GitHub as a single source of truth and integrating it with Cloudflare's edge network, the project ensures that documentation, terminal logic, and the AI engine are always synchronized and ready for production deployment with minimal manual intervention.
Sources: DEPLOYMENT_STATUS.md:158-175, QUICKSTART.md:144-148