Marek.media — portfolio a CMS
Vlastní headless CMS ve dvou jazycích, provoz na bezplatných tarifech. Fullstack monorepo: Next.js web, React administrace a NestJS API nad PostgreSQL.
Motivace
Portfolio je pro vývojáře vizitka, jenže statická šablona ukáže jen frontend. Cílem bylo, aby web sám ukazoval návrh a stavbu celé aplikace: databázi, API, administraci ovládanou AI, nasazení i provoz. Projekt je tedy primárně ukázkový.
Zároveň má fungovat jako skutečný produkt, ne jen demo:
obsah editovatelný bez nasazení, v češtině a angličtině,
náhled konceptů před publikováním,
rychlý statický web, který se po změně obsahu sám obnoví,
provoz za pár dolarů měsíčně a bez závislosti na jednom poskytovateli.
Hotový CMS by většinu z toho pokryl, ale datový model, API i oprávnění by určoval on a ukázal by hlavně práci s cizím nástrojem. Proto je celý stack vlastní.
Originalita
Prémiová služba si zaslouží originální design, ne výstup z promptu. Generativní AI dnes vyrobí web na pár promptů a je to poznat: stejné gradienty, stejné ilustrace, stejná rozvržení, grafika bez nápadu. AI slop.
AI je tu nástroj, ne autor. Design i architektura jsou vlastní práce. Místo nudné hero sekce si můžete zahrát skákací minihru.
SEO a výkon
ISR s on-demand revalidací, WebP varianty obrázků z CDN, Redis cache, canonical a hreflang, Open Graph, JSON-LD, generovaná sitemap, přesměrování 308.
Lidsky řečeno: web se načte rychle i na mobilu, změna obsahu je na něm ihned a vyhledávače ho správně zobrazí v obou jazycích.

Architektura
Turborepo s pnpm workspaces, tři aplikace, každá s produkcí a stagingem:
Aplikace | Stack | Hosting |
|---|---|---|
Web (marek.media) | Next.js (App Router, ISR, draft mode), React, Tailwind | Vercel |
Administrace (adm.marek.media) | React SPA, Vite, TanStack Router a Query, shadcn/ui, TipTap | Cloudflare Pages |
API (api.marek.media) | NestJS, Prisma, PostgreSQL, BullMQ, Swagger | Railway (Docker) |
Infrastruktura: PostgreSQL na Neonu, Redis (Valkey) na Aivenu, soubory v Cloudflare R2, e-maily přes Resend. Sdílené balíčky nesou design tokeny a utility. Typovaný API klient se pro web i administraci generuje ze Swagger schématu (Kubb), takže změna kontraktu API se okamžitě projeví v typech na frontendu.
API má 24 Prisma modelů a 7 nativních PostgreSQL enumů. Kromě CRUD obsahu řeší RBAC, audit log, soft delete s košem, přesměrování starých slugů, podepsané náhledy konceptů a zpracování obrázků do WebP variant na pozadí. Administrace obsahuje AI asistenta AURORA se 94 serverovými nástroji nad stejnými službami jako REST API.
Klíčová rozhodnutí a kompromisy
Rozhodnutí | Důvod | Kompromis |
|---|---|---|
Vlastní headless CMS vs Strapi / Payload | Projekt je primárně ukázkový: celý stack od databáze po frontend je vlastní práce a datový model, API i oprávnění odpovídají přesně potřebám webu. | Funkce, které hotový CMS má v základu (koš, náhledy, role), je potřeba napsat a udržovat. |
Bezplatné tarify (Neon, Vercel, Cloudflare, Aiven, Resend) a Railway za 5 USD měsíčně | Provoz téměř zdarma. | Limity tarifů, studený start databáze a víc služeb ke správě. |
Cloudflare R2 vs AWS S3 | S3-kompatibilní API a nulové poplatky za odchozí přenos, u webu plného obrázků podstatné. | Menší ekosystém navazujících služeb než AWS. |
Resend vs Mailgun | Modernější API a jednodušší integrace. | Bezplatný tarif je omezený na 3 000 e-mailů měsíčně. |
Railway vs Render (free) | API běží nepřetržitě. Free služba na Renderu se po 15 minutách bez provozu uspí, probuzení trvá zhruba minutu a s ní by stály i BullMQ workery. | Railway není zdarma, stojí 5 USD měsíčně. |
Aiven Valkey vs Upstash | BullMQ workery generují provoz do Redisu i nad prázdnou frontou. Upstash účtuje za každý příkaz a free limit 500 000 příkazů měsíčně by se vyčerpal za pár dní. Valkey na Aivenu příkazy nepočítá a je s Redisem plně kompatibilní. | Bezplatný tarif neumožňuje vybrat region. |
Turborepo vs Nx | Pro tři aplikace stačí minimum konfigurace. | Při třech aplikacích žádný. Výhody Nx (generátory, hranice modulů, automatické upgrady) se projeví až u velkého monorepa. |
Typy generované z OpenAPI vs sdílená Zod schémata | Validace formulářů se od validace API liší a sdílená schémata pokryla jen zlomek případů. Zdrojem pravdy je API, typy se z něj generují přes Swagger (Kubb). | Validace formulářů na frontendu (Zod) je samostatná a musí odpovídat validaci API. |
Prisma vs TypeORM | Typově bezpečné dotazy a schéma na jednom místě. | Některá databázová omezení Prisma ve schématu nepopíše, zůstávají v SQL migracích. |
Testy, CI a nasazení
CI na každém pull requestu: lint, typecheck, unit testy, e2e testy API přes Jest a Supertest na reálném PostgreSQL a Redisu (Testcontainers), vizuální regresní testy Storybooku v Chromaticu, automatické code review (CodeRabbit).
Vývoj s AI agenty. Kód vzniká s pomocí AI agentů (Claude Code), kteří se řídí pravidly a plány uloženými přímo v repozitáři. Vše důležité hlídají automatické testy.


