Skip to content

Add ADR: GitHub Pages hosting decision#50

Merged
marcarl merged 3 commits intomainfrom
docs/add-github-pages-hosting-adr
Jan 7, 2026
Merged

Add ADR: GitHub Pages hosting decision#50
marcarl merged 3 commits intomainfrom
docs/add-github-pages-hosting-adr

Conversation

@marcarl
Copy link
Copy Markdown
Collaborator

@marcarl marcarl commented Jan 7, 2026

Sammanfattning

Dokumenterar arkitektoniska beslutet att använda GitHub Pages som primär hosting-lösning för den genererade HTML-webbplatsen.

Vad har ändrats

  • ✨ Ny ADR-005: GitHub Pages som hosting för webbplatsen
  • 📝 Uppdaterad ADR README med länk till nya ADR:en

Motivering

GitHub Pages valdes som hosting-lösning för att det är:

  • Helt gratis för publika repositories
  • Enkelt med seamless integration i befintlig GitHub-baserad workflow
  • Automatiskt deployment via GitHub Actions (redan konfigurerat)
  • Funktionellt med inbyggd CDN, HTTPS och URL-rewrites

Alternativ som övervägdes

ADR:en dokumenterar fem olika alternativ:

  1. Cloudflare R2 - Billigt men URL-rewrites fungerar inte utan Workers
  2. Cloudflare R2 + Workers - Fungerar men kostar $5/månad
  3. Docker Container - Flexibelt men kräver hosting och mer komplexitet
  4. Traditionell hosting - Kostnad och underhåll
  5. Netlify/Vercel - Ingen fördel för vårt användningsfall

Migration

Eftersom det bara är statiska HTML-filer är migration till annan plattform trivial (< 1 timme). Cloudflare R2 finns redan som backup-lösning.

🤖 Generated with Claude Code

marcarl and others added 2 commits January 7, 2026 22:38
Dokumenterar beslutet att använda GitHub Pages som primär
hosting-lösning för den genererade HTML-webbplatsen.

Fördelar:
- Helt gratis för publika repositories
- Enkel integration med befintlig GitHub-baserad workflow
- Automatisk deployment via GitHub Actions
- Inbyggd CDN och HTTPS
- URL-rewrites fungerar automatiskt

Alternativ som övervägdes:
- Cloudflare R2 (finns som backup, men URL-rewrites fungerar inte)
- Cloudflare R2 + Workers (löser rewrites men kostar $5/månad)
- Docker Container (flexibelt men kräver hosting och mer komplexitet)
- Traditionell hosting (kostnad och underhåll)
- Netlify/Vercel (ingen fördel för statiska filer)

Migration är enkel tack vare att det bara är statiska HTML-filer.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Lägger till Amazon CloudFront + S3 som alternativ 6 i ADR-005.

Nyckelfynd:
- URL-rewrites fungerar INTE automatiskt för subdirectorier
- Kräver CloudFront Functions eller Lambda@Edge för rewrites
- CloudFront Functions: ~$0.10 per miljon requests
- S3 Static Website Endpoint är ett alternativ men kräver publik bucket

Detta är samma problem som Cloudflare R2 har - grundlösningen
fungerar inte för subdirectory rewrites utan serverless functions.

Källor:
- AWS Blog: CloudFront Functions for directory indexes
- AWS Blog: Lambda@Edge for directory indexes

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@marcarl marcarl changed the title Add ADR-005: GitHub Pages hosting decision Add ADR: GitHub Pages hosting decision Jan 7, 2026
- Replace example.com with selex.se throughout
- Update architecture diagram to show artifact-based deployment
- Replace gh-pages branch references with GitHub Actions artifacts
- Update deployment process to reflect actual workflow implementation

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@marcarl marcarl merged commit c9b5da1 into main Jan 7, 2026
5 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