https://github.com/omarj9/recipo
A Recipe Finder Web App with admin dashboard, built using Nextjs 15 and Postgresql database
https://github.com/omarj9/recipo
better-auth drizzle-kit drizzle-orm google-auth nextjs otpauth zod
Last synced: about 2 months ago
JSON representation
A Recipe Finder Web App with admin dashboard, built using Nextjs 15 and Postgresql database
- Host: GitHub
- URL: https://github.com/omarj9/recipo
- Owner: OmarJ9
- Created: 2025-03-23T23:29:02.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-04-01T18:20:43.000Z (2 months ago)
- Last Synced: 2025-04-01T19:32:38.704Z (2 months ago)
- Topics: better-auth, drizzle-kit, drizzle-orm, google-auth, nextjs, otpauth, zod
- Language: TypeScript
- Homepage:
- Size: 16.9 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🔥 Recipo - Find Your Perfect Recipe
Recipo is your ultimate recipe finder web app that helps you discover delicious dishes from around the world! Browse recipes by country, save your favorites, and create your own culinary journey.
## Star ⭐ the repo if you like what you see 😉.
## 🚀 Features
- 🌍 **Country-based Recipe Search** - Find recipes specific to different countries and cultures
- 🔍 **Advanced Filtering** - Filter recipes by country or difficulty
- 👤 **User Accounts** - Login with email OTP or Google Auth
- ❤️ **Favorite Recipes** - Add the recipes you like to your favorites
- 🌟 **Rate or Comment** - Add a rating and comments to recipes
- 🔎 **SEO Optimization** - Optimize SEO for better search engine indexing
- 👑 **Admin Dashboard** - Manage recipes, countries, and users (admin access only)
## 🛠️ Tech Stack
- ⚛️ **Frontend**: Next.js 15, React 19, Tailwind CSS, Shadcn UI
- 🔐 **Authentication**: Better-Auth
- 💾 **Database**: PostgreSQL, Drizzle ORM
- 🧪 **Form Validation**: React Hook Form, Zod
## 🔧 Getting Started
### Prerequisites
- Node.js 18+
- npm or yarn
- PostgreSQL database (supabase, neon...)
### Installation
1. Clone the repository:
```bash
git clone https://github.com/OmarJ9/recipo.git
cd recipo
```
2. Install dependencies:
```bash
npm install
# or
yarn install
```
3. Set up environment variables:
Create a `.env` file in the root directory with:
```
DATABASE_URL=your_postgresql_database_url
BETTER_AUTH_SECRET=your_better-auth_secret
BETTER_AUTH_URL=http://localhost:3000
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
```
4. Migrate the database:
```bash
npx drizzle-kit migrate
# or
yarn drizzle-kit migrate
```
5. Start the development server:
```bash
npm run dev
# or
yarn dev
```
6. Open [http://localhost:3000](http://localhost:3000) in your browser.
## 🖥️ Showcase
Here are some screenshots showcasing the web application:
## 📚 Project Structure
```
recipo/
├── src/ # Source files
│ ├── actions/ # Server actions
│ ├── app/ # App router components
│ │ ├── (auth)/ # Authentication routes
│ │ ├── admin/ # Admin dashboard
│ │ ├── recipes/ # Recipe-related pages
│ │ └── api/ # API routes
│ ├── components/ # UI components
│ ├── database/ # Database configurations
│ ├── hooks/ # Custom React hooks
│ ├── lib/ # Utility functions
│ └── types/ # TypeScript type definitions
└── public/ # Static files
```