Name: EverShelf
Author: Stimpfl Daniel

📸 Screenshot

Vedi EverShelf in Azione

Interfaccia moderna, colorata e mobile-first. Progettata per la vita reale.

←

01 / 09

Dashboard

Panoramica inventario con contatori per posizione (dispensa/frigo/freezer), avvisi di scadenza e tracciamento sprechi 30gg.

02 / 09

Inventario

Lista prodotti filtrabile per posizione e ricercabile per nome, con categoria, quantità e data scadenza.

03 / 09

Scanner Barcode

Scansiona con la fotocamera o inserisci manualmente. La modalità acquisti aiuta a registrare i prodotti in sequenza rapida.

04 / 09

Ricetta AI

Ricetta generata da Gemini AI con ingredienti in scadenza: ogni ingrediente è collegato all'inventario reale con quantità e posizione.

05 / 09

Storico Ricette

Storico delle ricette generate dall'AI, organizzate per giorno e pasto (pranzo/cena/altro), con tempi di preparazione e cottura.

06 / 09

Modalità Cucina

Guida passo-passo a schermo intero con Text-to-Speech. Ogni step mostra l'ingrediente con pulsante integrato 'Usa'.

07 / 09

Chat con AI

Assistente Gemini che conosce la tua dispensa, i tuoi elettrodomestici e le tue preferenze. Suggerisce pasti con un tap.

08 / 09

Lista della Spesa

Lista sincronizzata con Bring!, organizzata per categoria con indicatori di urgenza e link per cercare prezzi online.

09 / 09

Previsioni Smart

Analisi AI del consumo storico: mostra cosa sta finendo, quanto tempo rimane e perché è consigliato rifornirsi.

→

✨ Funzionalità

Tutto ciò di cui hai bisogno

Passa il mouse su ogni card per scoprire tutti i dettagli.

📦

Gestione Inventario

Tieni traccia di tutti i tuoi alimenti per posizione, categoria e scadenza. Niente più sprechi in cucina.

✓Scansione barcode con fotocamera
✓Dispensa, Frigo, Freezer e posizioni custom
✓Tracciamento prodotti aperti e sottovuoto
✓Stima automatica scadenza per tipo prodotto

Passa il mouse per i dettagli

🤖

Intelligenza Artificiale

Google Gemini AI identifica prodotti, legge scadenze dalle foto e genera ricette personalizzate.

✓Identificazione prodotto da foto
✓Lettura data scadenza da etichetta
✓Generazione ricette personalizzate
✓Chat intelligente sull'inventario

Passa il mouse per i dettagli

🛒

Lista della Spesa Smart

Sincronizzazione con Bring!, previsioni AI su cosa comprare e rimozione automatica alla scansione.

✓Integrazione Bring! shopping app
✓Previsioni smart sui consumi futuri
✓Rimozione automatica quando scansionato
✓Suggerimenti acquisto AI

Passa il mouse per i dettagli

🍳

Modalità Cucina

Guida passo-passo a mani libere con voce, timer automatico e tracciamento ingredienti usati.

✓Interfaccia cuoco a schermo intero
✓Text-to-Speech per ogni step
✓Timer automatico basato sulla ricetta
✓Segna ingrediente come 'Usato'

Passa il mouse per i dettagli

📊

Dashboard & Statistiche

Monitora i tuoi sprechi, ricevi alert sulle scadenze e valutazioni di sicurezza per ogni prodotto.

✓Tracciamento sprechi 30 giorni
✓Alert visivi per prodotti in scadenza
✓Valutazione sicurezza per categoria
✓Suggerimento ricette rapido con un tap

Passa il mouse per i dettagli

📱

Progressive Web App

Mobile-first, installabile come app nativa, multi-dispositivo. Funziona su qualsiasi browser.

✓Design mobile-first ottimizzato
✓Installabile su schermata home
✓Multi-dispositivo sullo stesso server
✓3 lingue: Italiano, Inglese, Tedesco

Passa il mouse per i dettagli

🚀 Installazione

Operativo in 3 Minuti

Due metodi di installazione. Consigliamo Docker per semplicità.

✅ Consigliato

🐳

Opzione A: Docker

Il modo più semplice. Un comando e sei pronto.

          
# 1. Clona il repository
git clone https://github.com/dadaloop82/EverShelf.git
cd EverShelf

# 2. Crea il file di configurazione
cp .env.example .env
nano .env

# 3. Avvia con Docker Compose
docker compose up -d

# → Apri http://localhost:8080
        

⚙️

Opzione B: Manuale

Richiede PHP 8.0+ con Apache o Nginx.

          
# Prerequisiti
# PHP 8.0+, pdo_sqlite, curl, mbstring

git clone https://github.com/dadaloop82/EverShelf.git
cd EverShelf
cp .env.example .env
chmod 755 data/
chown -R www-data:www-data data/
nano .env

# → Configura il tuo web server
        

📋 Requisiti di Sistema

PHP 8.0+ · SQLite 3 · Apache / Nginx · HTTPS (consigliato per fotocamera)

🔑 Config Opzionale AI

Chiave API Google Gemini (gratuita su aistudio.google.com)

Guida Completa →

🤝 Community

Contribuisci o Forkalo!

EverShelf è un progetto aperto. Chiunque può contribuire, suggerire funzionalità, segnalare bug o tradurre l'app nella propria lingua. Il codice è tuo: forkalo liberamente!

🍴

Forka

Crea la tua copia del progetto su GitHub

🌿

Branch

Crea un ramo per la tua funzionalità

💻

Sviluppa

Scrivi il codice e fai i tuoi commit

🚀

Pull Request

Invia la tua PR e diventa parte del progetto!

🍴 Forka su GitHub 🐛 Segnala un Bug 📖 Guida Contribuzione

🌐 Aiuta con le Traduzioni

Supporta già Italiano, Inglese e Tedesco. Vuoi aggiungere la tua lingua? Copia translations/it.json, traduci i valori e invia una PR!

👨‍💻 L'Autore

Chi c'è dietro EverShelf

👨‍💻

Stimpfl Daniel

Creatore & Sviluppatore di EverShelf

Ho creato EverShelf per risolvere un problema reale: sapere cosa c'è in casa, ridurre gli sprechi e cucinare meglio con quello che ho. È un progetto personale che condivido liberamente con la community — gratuito, open source e self-hosted, perché i dati sul tuo cibo appartengono solo a te.

@dadaloop82 evershelfproject@gmail.com ⭐ Metti una stella!

EverShelf

Vedi EverShelf in Azione

Tutto ciò di cui hai bisogno

Gratis. Per sempre. Davvero.

Operativo in 3 Minuti

Contribuisci o Forkalo!

Chi c'è dietro EverShelf