README.md

CodeLearn — Impara a Programmare | Versione 1.1.2c-3a - The Sync Update

il prossimo aggiornamento provvederà a chiudere il bug descritto in questa issue -> versione 1.1.2d-X

Con l' aggiornamento dopo dopo la 1.1.2d-X è prevista l'introduzione della dark mode -> versione 1.X.Xx-X

---

🚀 Caratteristiche

• 10 linguaggi di programmazione — Python, JavaScript, Java, Kotlin, Swift, C#, C++, C, PHP, HTML
• 100+ lezioni — teoria, esercizi pratici, quiz e progetti
• Editor di codice integrato — con syntax highlighting per tutti i linguaggi
• Gamification — XP, livelli, badge, streak,sfida giornaliera,easter egg.
• Percorsi di carriera — Frontend, Backend, Mobile, Full Stack, Systems, Game Dev
• Classifica — confrontati con altri studenti
• PWA + APK Android — installabile su iOS (via Safari -> deploy necessario per ultima versione, altrimenti usa la demo) e Android (via APK)
• Sincronizzazione dei progressi fatti tra telefono e sito vercel

se vuoi solo provare l'app ti basta andare su questo sito e aggiungere la scritta -GUEST alla fine del tuo username

se invece non vuoi che i tuoi progressi vengano salvati sul server, ma vangano salvati solo sul localhost aggiungi la scritta -LOCAL alla fine del tuo username

---

💽 Prova Versione Demo

L'app viene deployata automaticamente su Vercel e accessibile da qualsiasi browser moderno senza bisogno di installare niente, funziona su tutti i sistemi operativi (dal link)

https://code-learn-ruddy.vercel.app/

(se la versione è su sfondo arancione allora aprendo il link potrai usare una pre-release, se invece ha lo sfondo azzurro allora vuoldire he aprendo il link userai una release stabile)

https://codelearn-73ci.arcada.app

N.B. la contiene molti bug durante l' esecuzione di vari percorsi (impossibilità di completarli). Quindi se ti interessa usarla come si deve consiglio di usare la demo della oppure di scaricarti sempre l'ultima versione e/o fare da te il deploy

---

📦 Installazione (Windows/Mac/Linux)

Prerequisiti

• Node.js 20+
• npm
• java jdk 21

Clona e avvia

git clone <repo-url>
cd codelearn
npm install
npm run dev

L'app sarà disponibile all'indirizzo http://localhost:5173.

---

🤖 Build APK Android

Prerequisiti

• JDK 21
• Android SDK (platform-tools, platform android-34, build-tools 34.0.0)

Comandi manuali

npm install
npm run build
npx cap sync android
cd android
./gradlew assembleDebug

L'APK si troverà in android/app/build/outputs/apk/debug/app-debug.apk.

se dopo queste belle istruzioni che ho scritto con fatica e impegno continui a non avere capito niente ti consuglio di usare Claude AI (gratuita) per fare tutto.

---

📱 APK Prebuildato

Mi trovi alla pagina delle release.

N.B. è sconsigliato utilizzare il file apk su Android 11 e precedenti perché non carica correttamente la grafica (vedi gli screenshot. Se vuoi usarla su queste versioni ti consiglio di utilizzare la demo.

---

📁 Struttura del progetto

codelearn/
├── src/
│   ├── components/     # Componenti React
│   ├── context/        # Stato globale (progressi, utente)
│   ├── data/           # Dati corsi e lezioni
│   ├── lib/            # Utility e icone
│   ├── App.tsx
│   └── main.tsx
├── android/            # Progetto Android (Capacitor)
├── public/             # Asset statici
├── capacitor.config.ts
├── vite.config.ts
├── tailwind.config.js
└── package.json

---

🎯 Stack Tecnologico

Tecnologia	Uso
Vite	Build tool
React 19	UI framework
TypeScript	Tipizzazione
Tailwind CSS v4	Styling
Framer Motion	Animazioni
React Router	Navigazione
Lucide React	Icone
Capacitor	Wrapper mobile nativo

---

📝 Licenza

GNU GPL v3.0