MALÝ ZÁKLAD. VELKÝ NÁSKOK.
Váš další web začíná tady.
Rychlý web pro návštěvníky. Srozumitelná administrace pro klienta. Promyšlený základ pro všechno, co přijde potom.
- Jeden zvolený login
- Tři ukázkové jazyky
- Statické HTML jako základ
Co je uvnitř
Běžné základy už jsou připravené. Vzhled, obsah a doménu si přizpůsobíte konkrétnímu projektu.
01 / OBSAH
Sveltia bez výběru repozitáře
Klient otevře /admin, přihlásí se přes zvolený Google nebo Microsoft účet a rovnou upravuje obsah. GitHub účet nepotřebuje.
02 / RYCHLOST
Hotové HTML, minimum JavaScriptu
Astro generuje stránky při buildu. Malá SPA navigace a prefetch zrychlují další přechody; obsah funguje i bez JavaScriptu.
03 / PUBLIKACE
Git, historie a jeden build
Uložení vytvoří commit. Novější změna zruší starší build. Chyba ponechá poslední funkční verzi; kód se nasazuje výslovně.
04 / MÉDIA
AVIF, WebP a JPEG fallback
Build připraví responzivní varianty, rozměry a kompresi. Prohlížeč zvolí vhodný formát bez dalšího JavaScriptu.
05 / DOHLEDATELNOST
Metadata i jazykové varianty
Canonical, hreflang, sitemap, JSON-LD a Markdown mají společný základ. Přibalené SEO skills pomohou s obsahem a metadaty.
06 / KONTROLY
Kvalita jako součást práce
Bun check, lint a formatter, HTML validace, nezávislé accessibility enginy, testy hlaviček, cookies a rozpočtů výstupu.
Obsah, který můžete změnit
Tento blok se čte ze souborů spravovaných ve Sveltia CMS. Upravte nadpis, text nebo obrázek a sledujte novou verzi webu.
Dobré nápady rostou tady.
Pomáháme dobrým nápadům vyrůst. Spojujeme srozumitelný design, poctivé řemeslo a osobní přístup.
- Vizuální identita Značka, která vystihne, kdo jste.
- Webové stránky Přehledné weby, ve kterých se lidé snadno vyznají.
- Obsah a příběhy Dejte své práci prostor a srozumitelný příběh.
Celý základ, položku po položce
Přehled pro vývojáře: co šablona skutečně obsahuje, jak se kontroluje a co se nastavuje pro každý nový web. Všechny rozbalovací bloky fungují bez JavaScriptu.
01 / Web a rozhraní
- Astro SSG a Vite: hotové HTML, funkční obsah bez JavaScriptu, bez React hydratace a trvale běžícího Node webserveru.
- Odložená SPA navigace, historie a hover/focus prefetch. Přihlášení přechází plnou navigací. Cíle pro JS: základ 30 kB / 10 kB Brotli, všechny volitelné chunky 100 kB / 32 kB.
- CS/SK/EN, responzivní navigace, přepínač jazyků zachovávající stránku, skip link, karty, tlačítka, formulář a stavové zprávy.
- Nativní checkbox se SVG, animované FAQ bez JS, klávesnicový focus, pointer na aktivních prvcích, reduced motion a 6px scrollbar z CC workspace. Odkazy se podtrhují až při hoveru, ikony zůstávají samostatně.
02 / Obrázky, fonty a video
- Při buildu Sharp přímo převádí CMS obrázky z public/media: PNG/JPEG na AVIF, WebP a JPEG v šířkách 480/960/1440 bez zvětšování. Odstraňuje EXIF, otáčí podle orientace a v JPEG řeší průhlednost bílým pozadím.
- Picture/srcset/sizes, width/height, lazy/eager načítání, kvalita AVIF 45, WebP 78, JPEG 82. Nastavení encoderu je součástí hashe. SVG optimalizuje SVGO; favicon, manifest a OG obrázek se generují.
- Homepage LCP je prioritou: LCP obrázek bez lazy loadingu, vhodná priorita a responzivní preload. Výchozí fonty jsou systémové; vlastní fonty mají být subsetované WOFF2 s preloadem jen potřebných řezů.
- Nativní video komponenta: poster, rozměry, ovládání, titulky, přepis a preload=none. Pravidlem pro dodaná videa je AV1 + H.265 + H.264 fallback; automatický video transcoder není součástí.
03 / SEO a jazykové varianty
- Title/description, canonical, robots, Open Graph/Twitter, JSON-LD WebPage/WebSite, vzájemné hreflang a x-default pro CS/SK/EN.
- Plochá /sitemap.xml, robots.txt, llms.txt a Markdown přes obsahové vyjednávání; archiv soukromí je noindex. JSON-LD bezpečně escapuje obsah.
- Skills audit-serp-metadata a audit-seo-geo, včetně AITDK oblastí, metodiky, crawl nástrojů a Seonaut pixelové kontroly. Přístupy nejsou součástí Gitu.
- Offline JSON-LD validátor Adobe se slovní zásobou schema.org 30.1: typy/vlastnosti, rich-result pravidla, platná data s časovou zónou, absolutní URL, FAQ a odkazy @id.
04 / Formát, lint, typecheck a testy
- Bun fmt + Prettier/Astro plugin; Oxlint + TSRS/tsrs-lint spojuje lint a typecheck. Oxlint čte i skripty v .astro. Značky a přístupnost kontroluje ESLint s eslint-plugin-astro. Typy v šablonách kontroluje astro check.
- Stylelint pro CSS, kontrola indexů v TypeScriptu, Bun unit testy s minimálně 90 % pokrytí řádků a funkcí testovaných modulů, obrazové porovnání hlavičky a komponent. Go testy/vet a rušení procesového stromu. AJV kontroluje schémata, povolené soubory, datové typy, rozsah a rezervované URL.
- Každý build kontroluje HTML, metadata, odkazy, sitemap, jazykové vazby, obrazové varianty, EXIF, CSP kompatibilitu a rozpočty. Bun lock, přesné verze a dependency audit obou sad.
05 / Rozšířené audity
- Dvojí HTML validace: html-validate a lokální Nu HTML Checker. Přístupnost: axe-core, IBM Equal Access a Siteimprove Alfa; ruční a nejasné výsledky jsou oddělené.
- Puppeteer ověřuje SPA, prefetch, cookies a rozvržení při 320 px i se zvětšenými mezerami textu. HTTP kontroly ověřují také lokalizované 404, podmíněné požadavky a rozsahy.
- Samostatný Docker QA stack s testovacím HTTPS, bez reálných klíčů a dat. Lze vybrat enginy i URL. Dlouhé audity jen podle dopadu změny, s oznámením rozsahu a času; ne při každém Save.
06 / CMS, přihlášení a média
- Sveltia s pevně nastaveným repozitářem, JSON kolekcemi, přepínačem CS/SK/EN pro úvodní stránku, další stránky i archiv soukromí. Administrace má stejný 6px scrollbar jako web. Správa PNG/JPEG médií do 5 MiB.
- Google nebo Microsoft Entra OIDC přímo v nginx/OpenResty a Lua. PKCE, nonce, state, ověření podpisu a issueru; allowlist účtů, Microsoft tenant + object ID.
- HttpOnly session, SameSite=Lax, Secure na HTTPS, expirace, odhlášení a kontroly Origin. Oprávnění editora a operátora jsou oddělená. Klient nepotřebuje GitHub účet; přístup řeší serverová GitHub App.
07 / CI, CD, Git a publikace
- Kontrolní brána bun run verify běží v Dockeru a v serverovém buildu. Přibalený GitHub Actions CI/CD workflow není potřeba ani součástí šablony.
- Save zapisuje do větve content. Externí content push zachytí podepsaný webhook nebo polling. Main obsahuje kód; jeho push čeká na výslovné nasazení přes /ops nebo chráněné deploy API.
- Jeden build, sloučení rychlých změn, zrušení staršího buildu včetně podprocesů, přesné snapshoty a atomická publikace. Chybný nebo zastaralý build ponechá předchozí web.
- Konflikt stejného souboru se vrátí editorovi, různé soubory lze sloučit; žádný force push. Trvalá fronta, restart/recovery, historie a návrat k předchozímu kódu. Volitelný ruční dispatch může volat deploy API.
08 / Hlavičky, cache a soukromí
- Lightning CSS minifikuje CSS; Astro minifikuje HTML. Brotli 11 a gzip 9 se připravují při buildu. Hashované assety mají roční immutable cache a zůstávají dostupné i po dalším releasu; HTML se revaliduje.
- CSP bez spustitelného inline JS/eval na veřejném webu, externí CSS, nosniff, frame deny, Referrer/Permissions Policy, CORP/COOP, HSTS na HTTPS. Soukromé odpovědi mají no-store.
- Vanilla CookieConsent s CS/SK/EN, opt-in analytika a marketing, změna/odvolání souhlasu i napříč kartami. GA4, Ads a GTM jsou volitelné; bez nastavení se nenačítají.
- Consent Mode a SPA page views bez query/form dat, jediný loader, minimální posluchače. Veřejný web zachovává bfcache; právní obsah a archiv jsou součástí šablony k úpravě.
- Brotli/gzip cache podle obsahu a encoderu, limit 128 MiB na disku. CSP a dokumentové politiky jen na HTML; Server se neposílá. Volitelné CSP profily Google, Meta přes GTM a Tag Assistant, vlastní tagging originy.
09 / Provoz a předání projektu
- Tři Docker Compose služby: nginx/OIDC, Go koordinátor a Go build listener. Build používá pouze Bun; Node je jen v odděleném rozšířeném QA. Bez aplikační databáze; obsah a historie jsou v Gitu.
- Oddělené volumes, build cache na disku, limity RAM/CPU/PID, read-only kontejnery a no-new-privileges. Builder nemá klíče, coordinator volume ani Docker socket.
- Lokální testovací Git/OIDC fixture, integrační scénáře, healthcheck, logy a idle RAM/CPU měření přes Docker API. AGENTS.md, CLAUDE.md, architektura, setup, operace, provenance a doložené výsledky.
Přesné verze vývojových a auditních balíčků
Seznam se při sestavení čte z obou package.json. Tyto balíčky nejsou seznamem JavaScriptu stahovaného návštěvníkem; většina běží jen během buildu nebo auditu.
Web a build
-
Bun -
1.4.4 -
@adobe/structured-data-validator -
1.7.1 -
@astrojs/check -
0.9.12 -
@marbec/web-auto-extractor -
2.2.1 -
@sveltia/cms -
0.269.2 -
@types/bun -
1.4.4 -
@types/node -
24.19.2 -
ajv -
8.20.0 -
astro -
7.4.13 -
eslint -
10.15.0 -
eslint-plugin-astro -
3.2.1 -
eslint-plugin-jsx-a11y-x -
0.2.0 -
html-validate -
11.21.1 -
lightningcss -
1.33.0 -
node-html-markdown -
2.0.0 -
node-html-parser -
9.0.7 -
oxlint -
1.94.0 -
prettier -
3.10.1 -
prettier-plugin-astro -
1.1.2 -
sharp -
0.35.5 -
stylelint -
18.0.0 -
svgo -
4.1.0 -
tsrs -
0.25.0-ts7.1.0-beta -
typescript -
6.0.3 -
typescript-eslint -
8.73.0 -
vanilla-cookieconsent -
3.3.0
Rozšířené kontroly
-
Node -
24.22.3 (QA only) -
@siteimprove/alfa-act -
0.120.0 -
@siteimprove/alfa-puppeteer -
0.84.4 -
@siteimprove/alfa-rules -
0.120.0 -
@siteimprove/alfa-wcag -
0.120.0 -
accessibility-checker -
4.0.35 -
axe-core -
4.14.1 -
puppeteer -
25.18.1