A vibrant, interactive web application for sharing, discovering, and managing recipes with AI-powered search capabilities. Enjoy a delightful food-themed experience with a modern, responsive design.
- Create, edit, and delete your personal recipes
- Organize recipes with categories, cuisines, and ingredients
- Step-by-step cooking instructions
- User-friendly recipe editing interface
Our AI-powered search takes recipe discovery to the next level:
- Personalized Recommendations: Get recipe suggestions tailored to your preferences.
- Natural Language Understanding: Search using phrases like "quick vegan dinner" or "gluten-free desserts."
- Smart Ingredient Handling: Include or exclude specific ingredients effortlessly.
- Fallback Mechanisms: Enjoy reliable search results even when AI is unavailable.
This feature ensures that you always find the perfect recipe for any occasion, making cooking more enjoyable and stress-free.
Share My Recipe is more than just a recipe app—it's a community-driven platform where users can share their culinary creations, discover new recipes, and connect with fellow food enthusiasts. Whether you're a seasoned chef or a home cook, this portal is designed to inspire and bring people together through the love of food.
- Collaborative Recipe Sharing: Share your favorite recipes with the community.
- Discover Hidden Gems: Explore unique recipes from users around the world.
- Engage with Others: Comment on and favorite recipes to show appreciation.
- User authentication and profile management
- Personal recipe dashboard
- Mark recipes as favorites for quick access
- Responsive design works on all devices
- Flip-card UI with recipe instructions on the back
- Food-themed animated backgrounds and emoji effects
- Jewish cuisine recognition and special handling
- Multi-cuisine support (American, Italian, Mexican, Chinese, etc.)
- Ingredient glossary and term expansion
- Dietary preference recognition (vegetarian, kosher, gluten-free, etc.)
- Backend: Node.js with TypeScript
- Frontend: EJS templates, TailwindCSS
- Database: PostgreSQL with Liquibase for migrations
- Authentication: Passport.js
- AI Integration: Local AI model support (Mistral, VLLM, Ollama)
- Containerization: Docker & Docker Compose
- Node.js (v18+ recommended)
- PostgreSQL (v15+ recommended)
- Liquibase (for database migrations)
- Docker & Docker Compose (optional, for containerized setup)
git clone <your-repo-url>
cd share-my-recipenpm install- Make sure PostgreSQL is running
- Update environment variables or
src/index.tswith your database credentials - Create a database or use the default
postgresdatabase
liquibase updatenpm startThe app will be running at http://localhost:3000
The application supports various LLM backends for enhanced recipe search:
- Local AI: Connect to LocalAI, Ollama, or VLLM
- Environment Variables:
LLM_MODEL: Specify the model to use (e.g., 'mistral')
If the AI service is unavailable, the app falls back to standard search mechanisms.
- User Authentication: Register and log in to create and manage recipes
- Recipe Creation: Add recipes with title, description, ingredients, and instructions
- Recipe Discovery: Browse all recipes or search by keywords, categories, or cuisines
- AI-Powered Search: Get personalized recommendations based on natural language requests like "vegetarian pasta without mushrooms" or "kosher desserts"
- Favorites: Save recipes you love to your favorites list for easy access
- Profile Management: View and edit your profile information
npm testnpm run buildPull requests and issues are welcome! Enjoy sharing and discovering new recipes! 🍲