🎭✨ free4mood ✨🎭

Express Yourself. Share Your Vibe. Connect Freely.

free4mood is a modern social media platform designed for instant mood sharing and community connection. Built for performance and scalability using Next.js and MongoDB.

View Live Demo · Report Bug · Request Feature

---

📸 Screenshots

---

📍 Table of Contents

• 🚀 About the Project
• ✨ Key Features
• 🛠️ Tech Stack
• 🏁 Getting Started
  • Prerequisites
  • Installation
• 🤝 Contributing
• 📜 License
• 📬 Contact

---

🚀 About the Project

free4mood redefines social interaction by focusing on how users feel in the moment. Unlike traditional static profiles, free4mood allows users to set dynamic "Mood Statuses" that drive the content they see and who they connect with.

We built this using Next.js to ensure lightning-fast page loads via Server-Side Rendering (SSR) and excellent SEO optimization, backed by the flexibility of MongoDB.

---

✨ Key Features

• ⚡ High Performance: Built on Next.js App Router for optimal speed.
• 🎭 Mood Status: Update your current vibe (Happy, Chill, Energetic) to filter your feed.
• 📱 Fully Responsive: Mobile-first design using Tailwind CSS.
• 🔐 Secure Auth: Integrated authentication via NextAuth.js.
• 💬 Real-Time Chat: Instant messaging capabilities.
• 🌑 Dark Mode: Automatic theme switching based on system preferences.

---

🛠️ Tech Stack

We use a modern, robust React-based stack.

Category	Technology	Description
Framework		Full-stack React Framework
Language		Static Typing for Safety
Styling		Utility-first CSS
State		Minimalist State Management
Auth		Authentication Solution
Database		NoSQL Document Database
Deployment		Hosting & Edge Functions

---

🏁 Getting Started

Follow these instructions to set up free4mood on your local machine.

Prerequisites

• Node.js (v18.17.0 or later)
• npm or pnpm or yarn
• MongoDB (Local instance or MongoDB Atlas URL)

⚙️ Installation

1. Clone the repository

   git clone [https://github.com/yourusername/free4mood.git](https://github.com/yourusername/free4mood.git)
   cd free4mood

2. Install dependencies

   npm install
   # or
   yarn install
   # or
   pnpm install

3. Configure Environment Create a .env.local file in the root directory and add your keys:

   MONGODB_URI="mongodb+srv://user:password@cluster.mongodb.net/free4mood"
   NEXTAUTH_SECRET="your-super-secret-key"
   NEXTAUTH_URL="http://localhost:3000"

4. Run the Development Server

   npm run dev

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

---

🤝 Contributing

Contributions make the open-source community an amazing place to learn.

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

---

📜 License

Distributed under the MIT License. See LICENSE for more information.

---

📬 Contact

Your Name - @yourtwitter - email@example.com

Project Link: https://github.com/yourusername/free4mood