Groceasy

Groceasy is a self-hosted web and mobile app for managing household shopping lists with ease. Designed for families and housemates, it lets multiple users create, organize, and complete shopping lists collaboratively — all with powerful tagging, role-based permissions, and mobile-first usability.

Features

• Collaborative Lists: Multiple users can create and manage shopping lists together.
• Tagging: Organize items with customizable tags for easy filtering.
• Role-Based Permissions: Assign roles to users for secure and flexible list management.
• Mobile-First Design: Optimized for smartphones and tablets.
• Self-Hosted: Run Groceasy on your own server for privacy and control.

Getting Started

1. Clone the repository:

git clone https://github.com/DanielvG-IT/groceasy.git

2. Set up the .NET backend:

• Navigate to the backend directory:

  cd groceasy/backend/Backend.API

• Restore dependencies:

  dotnet restore

• Configure environment variables:
  Copy appsettings.example.json to appsettings.json and update settings as needed.

• Run the backend:

  dotnet run

3. Set up the Next.js frontend:

• Navigate to the frontend directory:

  cd ../frontend

• Install dependencies:

  npm install

• Configure environment variables:
  Copy .env.example to .env and update settings as needed.
• Start the frontend:

  npm run

4. Access the application:

• Open your browser and navigate to http://localhost:3000 for the frontend.
• The backend API will be running on http://localhost:5000 by default.

Screenshots

Coming soon