Introduzione

Card Game Kit è un construction kit neutro e guidato dal tema per giochi di carte collezionabili. Offre un motore completo, una control plane admin, un'API versionata, un client Flutter e uno strato web/SEO in un unico codebase. Tu porti tema, contenuti e brand.

Non è un gioco finito e non è un servizio ospitato: è la base che installi sul tuo server, rebrandizzi ed estendi.

Cosa significa "guidato dal tema"

Il motore non hardcoda gruppi, vocabolario o contenuti. Un file theme.yaml dichiara:

• i nomi dei collezionabili e le etichette;
• i gruppi di gioco e gli attributi;
• il modello di sesso e i moduli;
• i seeder che popolano il catalogo.

Cambi il theme pack e lo stesso motore adotta un altro universo. themes/neutral e themes/animalia-demo sono esempi, non il prodotto.

Cosa è incluso

• Motore: gare deterministiche, prove, punteggio, fusione, allevamento, ciclo di vita, requisiti, ambienti e simulatori.
• Applicazione: catalogo, collezione, pacchetti, economia, trading, aste, club, moderazione, onboarding, reputazione e ricompense.
• Admin: risorse Filament per contenuti, meccaniche, abilità, quiz, moderazione, media, localizzazione e operazioni.
• Client: app Flutter Android e web guidata da template creati in admin.
• Web e crescita: pagine pubbliche, ricerca avanzata, landing page, sitemap, share card, asset social, consenso e analytics.
• Tooling AI (opzionale): prosa con Ollama locale e immagini con Stable Diffusion.

Cosa è pianificato

• Un installer chiavi in mano con edizioni native, Docker e hybrid.
• Una demo pubblica rafforzata su demo.cardgamekit.com.
• Licenza e consegna aggiornamenti dopo il registro di completamento del kit.

Prossimi passi

• Architettura per capire i confini.
• Quick start per eseguire il kit in locale.
• Theme pack prima di progettare il tuo universo.