Fidelity Card

PWA Vue 3 per salvare, organizzare e condividere fidelity card senza backend custom.

🌐 Pagina progetto: https://savez.github.io/fidality-card/

🚀 Live demo: https://fidality-card.onrender.com

In breve

• 📷 Scansione barcode / QR dalla fotocamera
• ✍️ Inserimento manuale del codice
• 🏪 Brand italiani pronti all’uso
• ⭐ Card pinnabili e ordinate automaticamente
• 🔗 Condivisione via QR, link e Web Share API
• 📥 Import da QR / link condiviso
• 💾 Backup JSON completo
• 🌙 Tema salvato tra le sessioni
• 📱 Installabile come PWA, anche offline
• 🔒 Dati sempre locali in IndexedDB

Quick start

1. nvm use (Node 20)
2. npm install
3. npm run dev

Apri poi http://localhost:5173/.

Comandi utili

Comando	Cosa fa
npm run dev	Avvia il server locale
npm run build	Build di produzione
npm run preview	Anteprima della build
npm test	Esegue la suite Vitest
npm run lint	Controllo ESLint
npm run format:check	Verifica formattazione

Deploy su Render

Il deploy della demo passa da Render:

1. Crea un account su Render
2. New → Blueprint
3. Collega il repo savez/fidality-card
4. Conferma il servizio e avvia il deploy

Ogni push su main aggiorna la demo automaticamente.

Installazione come app

• Android / Chrome: menu ⋮ → Installa app
• iOS / Safari: Condividi → Aggiungi a Home
• Desktop: icona di installazione nel browser

Privacy

• Nessun login
• Nessun server custom
• Nessun dato card inviato fuori dal device
• Ogni installazione ha il suo IndexedDB isolato

Troubleshooting rapido

• Scanner non parte: serve HTTPS o localhost
• Database locale non disponibile: prova fuori dall’incognito o libera spazio
• Demo non aggiornata: verifica lo stato del deploy su Render

Contributing

Leggi CONTRIBUTING.md per ambiente di sviluppo, commit convention e PR.

Support

• Bug o feature request → Issue
• Domande o discussioni → Discussions

License

MIT — vedi LICENSE.