🛠️ DevCraft Items Management

A Premium & Seamless Full-Stack Item Discovery and Management Platform

Live Demo • Report Bug

---

📸 Overview

DevCraft is a cutting-edge web application engineered for developer tools, item management, and seamless organization. Powered by the Next.js App Router and secured with Better-Auth, it bridges the gap between high-performance data operations and a stunning user experience. Whether you are adding new developer resources or exploring curated assets, DevCraft handles it elegantly.

✨ Key Features

• 🔐 Bulletproof Authentication: Implemented secure user login, registration, and session persistence powered by Better-Auth, utilizing strict environment variable mappings.
• ⚡ Dynamic Item Discovery: Users can browse, search, and filter premium tools and resources through a high-performance /explore interface.
• 🏗️ Robust CRUD Operations: Authorized users can effortlessly Create, Read, Update, and Delete items with instant client-side UI synchronization.
• 🛡️ Multi-Environment Stability: Architected with dynamic baseURL routing (window.location.origin / env variables) to guarantee seamless switching between localhost:3000 and Vercel production.
• 🎨 Modern UX: Clean layouts built with utility-first responsive grids and optimized loading states for smooth data transitions.

🛠 Tech Stack

• Framework: Next.js (App Router with Server & Client Component separation)
• Authentication: Better Auth (React Integration)
• Styling & UI: Tailwind CSS
• Database Layer: MongoDB (via Mongoose / Native Driver)
• Deployment & Hosting: Vercel Production Platform

---

🚀 Getting Started

📋 Prerequisites

Ensure you have the following installed on your local machine:

• Node.js (v18.0.0 or higher)
• npm or yarn / pnpm
• A MongoDB Atlas account or local MongoDB instance

---

📦 Installation & Setup

Follow these steps to run the project locally on your machine:

# 1. Clone the repository
git clone [https://github.com/mahmudul-Hasan-2/RecipeHub-Client.git](https://github.com/mahmudul-Hasan-2/RecipeHub-Client.git)

# 2. Navigate into the project directory
cd RecipeHub-Client

# 3. Install the dependencies
npm install

# 4. Configure your environment variables
# Create a .env.local file in the root directory and add the following:
NEXT_PUBLIC_APP_URL=http://localhost:3000

# 5. Start the local development server
npm run dev

---

👥 Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request:

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'add: some amazing feature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

💡 Built with ❤️ by Mahmudul Hasan — Happy Coding! 🚀