👋 Hello World

Benvenuti in Astro-Theme-Aither.

Questo e un tema blog costruito su una convinzione: la buona scrittura merita una buona tipografia. Titoli in serif, un ritmo di lettura pulito e un layout che non si mette in mezzo. Tutto qui serve un unico obiettivo: far apparire e percepire le tue parole come belle.

Perche un altro tema blog

Il web e pieno di temi blog, quindi una domanda legittima e: perche costruirne un altro? La risposta sta nelle priorita. La maggior parte dei temi ottimizza per l’impatto visivo — grandi immagini hero, layout complessi, transizioni animate. Sono splendidi in una demo ma intralciano quando qualcuno si siede a leggere un articolo di 2.000 parole.

Astro-Theme-Aither parte da una premessa diversa. Il contenuto e il prodotto. Il compito del tema e presentare quel contenuto con la cura che merita: abbinamenti di font ponderati, spazi bianchi generosi e un ritmo verticale che rende la lettura lunga confortevole anziche estenuante.

Questa filosofia si estende anche alle decisioni tecniche. Il tema distribuisce circa 0,5 KB di JavaScript lato client — giusto il necessario per il toggle del tema. Tutto il resto e HTML statico e CSS. Nessun layout shift, nessuno spinner di caricamento, nessun framework JavaScript che si idrata in background. La pagina si carica e tu leggi.

Per iniziare

Essere operativi richiede solo pochi minuti. Ecco il processo completo:

Clona il repository — usa il pulsante template di GitHub o clona direttamente con git clone
Installa le dipendenze — esegui pnpm install per scaricare tutti i pacchetti
Configura il tuo sito — modifica src/config/site.ts per impostare il titolo del sito, la descrizione e i link di navigazione
Sostituisci il contenuto di esempio — sostituisci i post in src/content/posts/ con i tuoi file Markdown
Inizia a sviluppare — esegui pnpm dev per avviare il server di sviluppo locale con hot reloading
Distribuisci — pusha su GitHub e lascia che il workflow CI incluso gestisca il deploy su Cloudflare Pages

Struttura del progetto

La codebase e organizzata per essere immediatamente comprensibile:

src/
├── components/     # Componenti Astro riutilizzabili
├── config/         # Configurazione del sito
├── content/        # I tuoi post Markdown e contenuti
├── layouts/        # Layout delle pagine (Layout.astro)
├── pages/          # Pagine delle route
└── styles/         # CSS globale con token Tailwind v4

Ogni directory ha una responsabilita chiara. I componenti sono piccoli e componibili. I layout gestiscono il guscio del documento. Le pagine definiscono le route. Il contenuto ospita la tua scrittura. Non c’e magia — solo file ben organizzati.

Scrivere il tuo primo post

Crea un nuovo file .md in src/content/posts/ con il seguente frontmatter:

---
title: Il titolo del tuo post
date: 2026-01-15
category: General
description: Un breve riassunto per SEO e anteprime social
tags: [Argomento, Altro]
---

Il tuo contenuto inizia qui.

I campi title, date e category sono obbligatori. Il campo description e fortemente raccomandato perche popola il tag meta description e le anteprime Open Graph. I tag sono opzionali ma aiutano i lettori a scoprire contenuti correlati.

Cosa ottieni

Pronto all’uso, hai una piattaforma di blogging production-ready con ogni funzionalita di cui hai bisogno e nessun sovraccarico superfluo.

Funzionalita dei contenuti

Feed RSS — generato automaticamente su /rss.xml, compatibile con ogni lettore di feed
Sitemap — auto-generata tramite @astrojs/sitemap per l’indicizzazione nei motori di ricerca
Meta tag SEO — Open Graph, Twitter cards e URL canonici su ogni pagina
Modalita scura — toggle a tre vie (Chiaro / Scuro / Sistema) con persistenza localStorage
Pagine per categoria e tag — archivi organizzati per sfogliare per argomento

Funzionalita per sviluppatori

TypeScript ovunque — strict mode, componenti e utility completamente tipizzati
Content Collections — sistema integrato di Astro per Markdown type-safe con validazione del frontmatter
Tailwind CSS v4 — usando design token @theme per personalizzazione facile di colori, font e spaziature
Vitest + Playwright — test unitari e end-to-end gia integrati nella pipeline CI
Cloudflare Pages — workflow di deploy con URL di anteprima automatiche per le PR
Google Analytics — opzionale, isolato in un Partytown Web Worker per non bloccare mai il thread principale

Prestazioni

Poiche il tema produce HTML statico con JavaScript minimo, le prestazioni sono eccellenti per impostazione predefinita. Ci si puo aspettare punteggi Lighthouse di 100 su tutta la linea — Performance, Accessibilita, Best Practices e SEO. Non c’e nulla da ottimizzare perche non c’e nulla di superfluo.

Personalizzazione

Il tema e progettato per essere tuo. Le personalizzazioni piu comuni sono immediate:

Colori — modifica le proprieta CSS personalizzate in src/styles/global.css per cambiare l’intera palette
Font — scambia i valori font-family nella configurazione del tema Tailwind
Navigazione — aggiorna l’array dei link di navigazione in src/config/site.ts
Analytics — aggiungi il tuo ID di misurazione Google Analytics nella configurazione del sito

Per cambiamenti piu profondi, l’architettura dei componenti e deliberatamente semplice. Non ci sono astrazioni profondamente annidate o pattern di gestione dello stato complessi. Ogni componente fa una cosa, legge i suoi props e renderizza HTML.

Una nota sulla filosofia del design

La semplicita visiva di questo tema e intenzionale, ma non e la stessa cosa della semplicita ingegneristica. Sotto il cofano, il tema gestisce un numero sorprendente di aspetti: scale tipografiche responsive, rapporti di contrasto dei colori accessibili sia in modalita chiara che scura, struttura HTML semantica corretta, gerarchia dei titoli corretta e attenzione meticolosa all’esperienza di lettura su schermi che vanno dai telefoni agli ultrawide.

Il buon design e invisibile. Quando leggi un articolo su questo tema e semplicemente ti godi la scrittura senza notare il tema — e il design che funziona esattamente come previsto.

Buona scrittura.