Site Architecture

SolveForce Dual-Site Architecture β€” Two repositories serving different purposes with proper DNS separation.

πŸ—οΈ Architecture Overview

SolveForce operates a dual-repository architecture to separate concerns and optimize deployment:

πŸ“š Documentation Site (SOLVEFORCE.COM)

  • Repository: solveforceapp/SOLVEFORCE.COM
  • URL: https://solveforceapp.github.io/SOLVEFORCE.COM/
  • Purpose: Comprehensive technical documentation (75+ pages)
  • Technology: mdBook (Rust-based static site generator)
  • DNS: No custom domain - uses default GitHub Pages URL
  • Content:
    • πŸ“š Axionomic Codex v5.18 (126 Nomos, 9 operators)
    • 🧩 Five Pillars documentation
    • πŸ› οΈ Services & integration guides
    • πŸ“‹ Complete site directory

🌐 Portal Site (portal-solveforce)

  • Repository: solveforceapp/portal-solveforce
  • URL: https://portal.solveforce.com (custom domain)
  • Purpose: Modern landing page and service portal
  • Technology: Pure HTML/CSS/JavaScript
  • DNS: Custom domain via CNAME (portal.solveforce.com)
  • Content:
    • 🎨 Modern gradient design
    • 🏒 Service overview cards
    • πŸ“ž Contact information
    • πŸ”— Links to documentation

πŸ”§ DNS Configuration

Portal Repository (portal-solveforce)

CNAME file content: portal.solveforce.com
GitHub Pages: Enabled with custom domain
Cloudflare CNAME: portal β†’ solveforceapp.github.io

Documentation Repository (SOLVEFORCE.COM)

No CNAME file (correctly absent)
No custom domain configuration
Uses default GitHub Pages URL: /SOLVEFORCE.COM/

πŸš€ Deployment Strategy

Why Separate Repositories?

  1. Different Technologies: mdBook vs. static HTML
  2. Different Purposes: Documentation vs. marketing/portal
  3. Different DNS Needs: Custom domain vs. GitHub Pages default
  4. Independent Deployment: Changes to portal don't affect docs
  5. Scalability: Each site can evolve independently

Cross-References

Both sites maintain cross-references:

  • Portal β†’ Documentation: Links to comprehensive guides
  • Documentation β†’ Portal: References modern landing page
  • Consistent Branding: Shared contact info (888) 765-8301

πŸ“Š Current Status

AspectDocumentation SitePortal Site
Statusβœ… Deployedβœ… Deployed
URLGitHub Pages defaultCustom domain
Pages75+1 (landing)
TechnologymdBookHTML/CSS/JS
DNSNoneCNAME configured
PurposeTechnical docsMarketing/portal

πŸ”— Quick Links

Contact: πŸ“ž (888) 765-8301 β€’ βœ‰οΈ contact@solveforce.com

Architecture: Dual-site separation | DNS: Portal custom, docs default | Status: Fully operational