Thyme Manager

Overview

A modern recipe management application that helps you organize your recipes, plan your weekly meals, and generate AI-powered meal prep plans. Built with Next.js 15 and React 19, it provides an intuitive interface for managing your culinary journey.

Features

• Recipe Management: Store and organize all your favorite recipes in one place
• Calendar Planning: Schedule recipes for specific days to plan your weekly meals
• AI Meal Prep: Generate personalized meal prep plans using OpenAI integration
• Shopping Lists: Automatically generate shopping lists from your scheduled meals
• Modern UI: Clean, responsive interface built with Radix UI and Tailwind CSS

Tech Stack

• Next.js 15 - React framework with App Router
• React 19 - Latest React features
• Tailwind CSS 4 - Utility-first CSS framework
• Radix UI - Accessible component library
• OpenAI API - AI-powered meal prep planning
• Lucide Icons - Beautiful icon library
• Zod - Schema validation

Requirements

• Node.js 18.0.0 or higher
• OpenAI API key (for meal prep generation)

Installation

1. Clone the repository:

git clone [repository-url]
cd recipes

2. Install dependencies:

npm install

3. Set up environment variables:

cp .env.example .env.local
# Add your OpenAI API key to .env.local

4. Run the development server:

npm run dev

Open http://localhost:3000 with your browser to see the result.

Usage

Adding Recipes

Navigate to the Recipes tab to add new recipes with ingredients and instructions.

Planning Meals

Use the Calendar tab to schedule recipes for specific days of the week.

Generating Meal Prep Plans

Once you have recipes scheduled, go to the Meal Prep tab to generate an AI-powered prep plan that includes:

• Combined shopping list
• Sunday prep instructions
• Daily cooking instructions

Project Structure

recipes/
├── src/
│   ├── app/              # Next.js app directory
│   │   ├── actions.js    # Server actions
│   │   ├── layout.js     # Root layout
│   │   └── page.js       # Main page
│   ├── components/       # React components
│   │   ├── CalendarView.js
│   │   ├── MealPrep.js
│   │   ├── RecipesList.js
│   │   └── ui/          # UI components
│   └── lib/             # Utility functions
├── public/              # Static assets
├── package.json
└── README.md

Development

Run the development server:

npm run dev

Build for production:

npm run build

Start production server:

npm start

Run linting:

npm run lint

Environment Variables

Create a .env.local file with:

OPENAI_API_KEY=your_openai_api_key_here

Contributing

Feel free to submit issues and pull requests to improve the application.

Notes

• The application uses Next.js 15 with the App Router
• All components use React 19 features
• Tailwind CSS 4 is configured for styling
• OpenAI integration requires a valid API key

License

MIT - See LICENSE for details

Authors

Alice Li Jahvon Dockery Michael Monaghan