How eylonhotam/grocy-pantry-bot works
Grocy is a lightweight, browser-based pantry assistant. A user enters a grocery command in the chat; the parser adjusts a known item's quantity or guides the user through category and threshold selection for a new item. Inventory changes persist in localStorage and appear in the sidebar, where low-stock items are visually marked. The parser can also produce a shopping list from items at or below their thresholds. The implementation is concentrated in app.js; the README documents capabilities, but its project-structure paths do not match the supplied file tree, so only tree-supported paths are used here.
Main entry points: app.js Command chat · index.html App shell · styles.css Visual styles
Components 11
Chat interaction
- Command chat
app.js - Inventory sidebar
app.js - Low-stock alerts
app.js - App shell
index.html - Visual styles
styles.css
Pantry logic
- Item onboarding
app.js - Command parser
app.js - Shopping list
app.js - Inventory model
app.js
Browser state
- Local storage
Other components
- Pantry user
Connections 11
- Pantry user → Command chat: enters commands
README.md - Command chat → Command parser: processes input
app.js - Command parser → Item onboarding: requests item details
app.js - Command parser → Inventory model: updates or adds
app.js - Command parser → Shopping list: checks thresholds
app.js - Inventory model → Local storage: loads and saves
app.js - Command chat → Inventory sidebar: refreshes view
app.js - Inventory sidebar → Inventory model: reads items
app.js - Inventory sidebar → Low-stock alerts: marks low quantities
app.js - App shell → Command chat: hosts interface
README.md - Visual styles → Command chat: styles interface
README.md