Skip to content

wikankun/suppli

Repository files navigation

Suppli 🧼🍜📦

Simple stock management for household items

Suppli helps you and your family keep track of essential household items—like face wash, dish soap, soy sauce, salt, tissues, and more—so you never run out when you need them most.

✨ Features

  • 📋 Manage categories like Personal Care, Cleaning Supplies, and Condiments
  • 📦 Add, edit, and delete items with current stock info
  • 🔔 Set low stock alerts (soon)
  • 📊 Visual overview of what's running out
  • 📱 Mobile-friendly interface

🛠️ Tech Stack

📦 Getting Started

1. Clone the repo

git clone https://github.com/wikankun/suppli.git
cd suppli

2. Install dependencies

pnpm install

3. Run the development server

pnpm run dev

Open http://localhost:3000 in your browser to see Suppli in action.

📁 Project Structure

/app        - Application pages & routing (Next.js App Router)
/components - Reusable UI components
/lib        - Utility functions & helpers
/styles     - Global styles and Tailwind config

🤝 Contributing

This project is currently personal, but feel free to fork it and make it your own! Feedback, PRs, or feature requests are welcome.

📜 License

MIT © Wikan

Made with ❤️ for my wife who always remembers what we’re out of.

About

Simple stock management for household items

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published