Meal Planner

An app to help plan meals and shops.

Add ingredients, create meals with those ingredients, and produce a shopping list for those meals, helpfully organised by category.

Run locally

1. Install Docker
2. Run docker compose up
3. The application should now be running on http://localhost:4200

Local development

1. Install node 20 and npm. I recommend using nvm for this - once installed, run nvm install in this repo to get the relevant version.
2. Install Go
3. Run npm install
4. Run npm run serve to start the API and UI locally with hot reloading.

Features

• Add ingredients
• Create and edit meals with ingredients in different units/quantities
• Add meals to shops
• View ingredients needed for entire shop, grouped by category
• Add ingredients to basket, to tick them off from the shopping list
• In progress: uploading meals from CSV

Technical notes

• This repo uses nx for managing the API and client apps in a monorepo
• The API uses hallgren/event-sourcing, and stores events in a local SQLite database.