Stack technologiczny — co stoi za tym blogiem
Astro, TypeScript, Tailwind i Cloudflare — krótki przegląd narzędzi, na których działa ten blog, bez marketingowego bełkotu.
uid zero
IT · SysOps · Helpdesk
Ten blog nie jest WordPressem z dwudziestoma wtyczkami ani aplikacją React, która ładuje pół internetu, żeby wyświetlić trzy akapity tekstu. To strona contentowa: Markdown, szybki HTML, minimum JavaScriptu po stronie klienta.
Warstwa prezentacji
Astro 5
Główny framework. Astro generuje statyczne strony tam, gdzie to możliwe, a JavaScript dokłada tylko tam, gdzie naprawdę potrzeba (u nas: praktycznie nigdzie — brak wysp React/Vue).
Co z tego korzystamy:
- Content Collections — wpisy w katalogu bloga ze schematem Zod
- Routing plikowy — strony mapują się na URL-e z katalogu
pages - Komponenty
.astro— layouty, nawigacja, karty postów - Shiki — podświetlanie składni w blokach kodu
Tailwind CSS 3 + Typography
Stylowanie utility-first + plugin typografii dla treści artykułów. Tryb ciemny przez darkMode: 'class' i przełącznik w nawigacji.
Fonty: Inter (tekst), JetBrains Mono (kod).
Treść i dane
| Element | Technologia |
|---|---|
| Wpisy | Markdown (.md) |
| Walidacja frontmatter | Zod w Content Collections |
| Autorzy | Pola w YAML + domyślny autor w konfiguracji |
| Czas czytania | Własna utilka |
| Tagi / kategorie | Filtrowanie kolekcji + strony paginowane |
Nowy post = nowy plik Markdown + frontmatter. Bez panelu admina, bez bazy — i o to chodzi.
SEO i dystrybucja
- Meta tagi — Open Graph, Twitter Cards, canonical
- Sitemap — generowany automatycznie
- RSS — kanał po polsku
- Okładki — opcjonalne pole w frontmatter
Hosting i deploy
Strona jest przygotowana pod Cloudflare:
- adapter Cloudflare
- build + deploy przez Wrangler
- assety statyczne w katalogu publicznym
TypeScript
Projekt jest w TypeScript (config, utils, typy). Content Collections dają typowanie wpisów — mniej literówek w polach frontmatter niż w notatniku.
Czego świadomie nie ma
- React / Vue / Svelte w UI (zero frameworków SPA do czytania bloga)
- Bazy danych i CMS-a
- Ciężkiego bundla JS na stronie głównej
- Komentarzy pod postami (na razie; spokój jest cenniejszy)
Podsumowanie
| Warstwa | Stack |
|---|---|
| Framework | Astro 5 |
| Język | TypeScript |
| Style | Tailwind CSS 3 + Typography |
| Treść | Markdown + Content Collections (Zod) |
| Deploy | Cloudflare (Wrangler) |
| Dodatki | RSS, sitemap, Shiki, dark mode |
To zestaw pod blog tekstowy: szybki, tani w utrzymaniu, łatwy do wersjonowania w Gicie. Jak kiedyś dodamy komentarze albo wyszukiwarkę — pewnie też bez dokładania całego ekosystemu.