Skip to content

and/inventory

Repository files navigation

Home Inventory App

A mobile-first PWA to track your kitchen and pantry inventory. Items turn yellow when running low and red when depleted so you know exactly what to buy.

Features

  • Add items with name, quantity, unit, and category
  • Tap / + on any card to adjust quantity instantly
  • Items sorted: depleted → low → in-stock
  • Category tabs and search
  • Stats bar showing counts at a glance
  • Google Sheets sync — push your inventory to a spreadsheet you can view on any device
  • Installable as a PWA (works offline)

Quick Start

npm install
npm run dev

Open http://localhost:5173 on your phone (same Wi-Fi) or deploy to Vercel/Netlify.

Google Sheets Sync (optional, ~5 minutes setup)

  1. Go to console.cloud.google.com
  2. Create a project → APIs & Services → Enable APIs → Google Sheets API
  3. Credentials → Create OAuth 2.0 Client ID → Web Application
    • Add your app URL as an Authorised JavaScript origin (e.g. http://localhost:5173 for dev, or your deployed URL)
  4. Copy the Client ID
  5. Create a blank Google Sheet and copy its ID from the URL (the long string between /d/ and /edit)
  6. In the app tap ⚙︎ → Google Sheets Sync, paste both values, then tap Sign in with Google
  7. Tap ↑ Push to Sheets to sync — your spreadsheet will have a colour-coded Inventory sheet!

Deploy

npm run build
# dist/ folder → deploy to Vercel, Netlify, or any static host

Generating PWA Icons

npm install sharp
node generate-icons.mjs

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors