INFRASTRUCTURE: Integrate education site with main ucospo.net domain #35
Description
Goal
Integrate the education subsite with the main UC OSPO website (ucospo.net) to provide seamless navigation and professional domain structure.
Current Setup
- Main site: https://ucospo.net/ (repo: UC-OSPO-Network/ucospo.net)
- Education site: https://UC-OSPO-Network.github.io/education (repo: UC-OSPO-Network/education)
Recommended Approach: Subdomain
Target URL: education.ucospo.net
Tasks
DNS Configuration
- Access domain registrar for ucospo.net
- Add CNAME record:
- Type: CNAME
- Name: education
- Value: UC-OSPO-Network.github.io
- Verify DNS propagation (may take 24-48 hours)
Education Repo Updates
- Add CNAME file to public/ directory
- Update astro.config.mjs (change base from /education to /)
- Update all internal links from /education/... to /...
GitHub Pages Configuration
- Go to education repo Settings → Pages
- Set custom domain to education.ucospo.net
- Enable Enforce HTTPS (after DNS propagates)
Cross-Site Navigation
- Main site: Add Education link in navbar
- Education site: Add UC OSPO Home link in header
- Ensure consistent branding between sites
Testing
- Verify education.ucospo.net loads correctly
- Test all navigation links work
- Verify SSL certificate is active
- Test on mobile and desktop
- Check that all assets load (CSS, images, fonts)
Alternative Approaches Considered
Option 2: Subdirectory Path (ucospo.net/education)
Requires: Build integration, reverse proxy, or repo merge
Complexity: High
Decision: Not recommended due to maintenance overhead
Option 3: Keep Current GitHub Pages URL
Simplest: Just add cross-linking
Decision: Less professional than custom domain
Success Criteria
- Education site accessible at education.ucospo.net
- HTTPS enabled
- Navigation between sites works seamlessly
- Branding is consistent
- All existing functionality preserved
Reference
- GitHub Pages custom domains: https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site
- Astro base path: https://docs.astro.build/en/reference/configuration-reference/#base