Skip to content

joao-carmassi/shop-smart

Repository files navigation

✅ Checklist App

A simple and modern checklist app built with Next.js, Zustand, ShadCN/UI, and Tailwind CSS.
The app lets you create, group, and track your tasks or shopping items, and share them easily with others.


🚀 Features

  • 📝 Create Items – Add items to your list and organize them by custom groups.
  • Check Off Items – Mark what you’ve already done or bought.
  • 🗂️ Group Organization – Separate items into groups for better structure.
  • 🔗 Shareable Links – Generate a share link to send your list to others.
    • When someone opens your link, your shared list is added to their app without replacing their existing items or states.
  • 💾 Persistent State – Your data is stored locally using Zustand for smooth, stateful management.
  • 🎨 Beautiful UI – Styled with ShadCN/UI and Tailwind CSS for a clean and responsive look.

🧠 Tech Stack

  • Next.js 14+ (App Router)
  • TypeScript
  • Zustand – state management
  • ShadCN/UI – UI components
  • Tailwind CSS – styling

⚙️ Setup

# Clone the repo
git clone https://github.com/your-username/checklist-app.git

# Go into the project folder
cd checklist-app

# Install dependencies
npm install

# Run the development server
npm run dev

Then open http://localhost:3000 🚀


🧩 Project Structure

src/
 ├─ app/           # Next.js app routes
 ├─ components/    # Reusable UI components (ShadCN)
 ├─ store/         # Zustand store (state management)
 ├─ lib/           # Utilities and helper functions
 └─ rypes/        # Global Tailwind styles

⭐ Feel free to fork and customize your own version!

About

A simple and intuitive shopping list app to help you organize your groceries, track purchases, and never forget an item again. Built for efficiency and ease of use.

Resources

License

Stars

Watchers

Forks

Contributors