A modern, handy, feature-rich recipe management application that helps you organise, customise, store, collect and convert your favorite recipes.
# Clone repo
git clone https://github.com/yourusername/recipes-app.git
cd recipes-app
# Start frontend
npm install
npm run dev
# Start backend
cd backend
pip install -r requirements.txt
flask db upgrade
python3 app.py- Add by URL – Automatically scrape recipes from popular cooking websites
- Manual entry – Create your own recipes from scratch with a user-friendly form
- Smart parsing – Automatically extracts ingredients, instructions, prep time, and servings
- Search Quickly find recipes by name or ingredients with smart scoring
- Card grid display: Browse recipes in a clean, visual card layout
- Recipe Details View comprehensive recipe information on dedicated pages
- Delete Recipes Remove unwanted recipes with a single click
- Editing Edit title, ingredients, instructions, and notes
- Image upload Add or update recipe images via URL or file upload
- Personal notes Add your own tips, modifications, and comments to any recipe
UK/Imperial ↔ Metric: Toggle between measurement systems with one click Smart Conversion: Automatically converts:
Cups, ounces, pounds → grams/milliliters Tablespoons/teaspoons (for butter) → grams Fahrenheit → Celsius Handles fractions (1/2, 1 1/4, etc.)
- Checkboxes Mark ingredients as you add them while cooking
- Real-time conversion See measurements in your preferred system instantly
- Line-by-line display Clean, easy-to-read ingredient list
- Auto-formatting Automatically detects and numbers multiple steps
- Single step support Displays single instructions without numbering
- Editable Modify cooking instructions anytime
- Responsive design Works seamlessly on desktop, tablet, and mobile
- Clean interface Modern, intuitive UI with smooth animations
- Component architecture Built with reusable React components for maintainability
⚛️ [React] — UI framework
🧭 [React Router] — Navigation
🎨 CSS3 — Styling with CSS variables for theming
⚡ [Vite] — Build tool and development server
🐍 [Flask] — REST API
🐘 [PostgreSQL] — Database
🧾 [SQLAlchemy] — ORM
🍽️ [recipe-scrapers] — Web scraping library
Node.js (v18+) Python (v3.8+) PostgreSQL
Clone the repository
git clone https://github.com/yourusername/recipes-app.git
cd recipes-app </pre>Install frontend dependencies
npm install
Start the development server
npm run dev
Navigate to the backend directory
cd backend
Install backend dependencies
pip install -r requirements.txt
flask db upgrade
python3 app.py
User authentication and personal accounts
Recipe categories and tags
Meal planning calendar
Shopping list generation
Recipe sharing and social features
Nutrition information
Recipe ratings and reviews
Russian/Ukrainian recipe parsing
Android/iOS mobile apps
Recipe collections and favorites
Contributions are welcome!
- Fork the repo
- Create a new branch
- Commit your changes
- Submit a Pull Request
This project is licensed under the MIT License.