Daccotta 🌟

A Social Network for Movie Lovers

Hey movie lovers! Welcome to Daccotta, a web app designed to simplify your movie-watching experience and make it easy to share your favorite films with friends. Think of us as your go-to social network for everything movies! 🎥🍿

Love it? 👉 Don't forget to star this repo! 🌟

🌟 Stars	🍴 Forks	🐛 Issues	🔔 Open PRs	🔕 Close PRs

---

also be a part of the community and join our discord .

This project is now OFFICIALLY accepted for

Name	Logo	Purpose
GSSoC'2024-Extd		The coding period is from October 1st to October 30th, during which contributors make contributions and earn points on the platform.
Hacktoberfest 2024		Hacktoberfest is a month-long October event welcoming all skill levels to join the open-source community.

---

📑 Table of Contents

1. 🎬 What is Daccotta?
2. 🔑 Key Features
   • 🚧 Coming Soon Features
3. 🛠️ Tech Stack
4. 🚀 Getting Started
   • 🗂️ Setting Up Daccotta Repository
   • 🔧 Installing Node.js + pnpm
     • 🍎 For macOS
     • 🪟 For Windows
   • 🖥️ Frontend-Only Setup
   • 🗂️ Setting Up Full Stack Daccotta
     • 💾 Setting Up MongoDB Atlas
     • 🔐 Setting Up Auth (better-auth)
     • ⚙️ Running the Full Stack Project
5. ❤️✨ Our Valuable Contributors
6. 🤝 Contributing
7. 📧 Contact
8. ⚠️ Attribution

🎬 What is Daccotta?

Daccotta is a platform built for film enthusiasts to discover, and showcase their taste in movies with like-minded individuals. You can create your own lists, add journal entries of the movies you have watched and get recommendations on the basis of your lists and journal entries. Daccotta a community that brings people together through a shared love of cinema.

---

🔑 Key Features

1. 🎞️ List Creation: Create and manage your own movie lists.
2. 📖 Movie Journals: Keep a personalized journal entry for every movie you watch.
3. 📊 User Stats: Get insights into your movie-watching habits.
4. 🤖 personalized reccomendations: Get personalized reccomendations based on your movie watching habits.

Coming Soon:

5. 👥 Group Creation: Form groups with friends to compare and share your movie stats.
6. 📈 Group Stats: View combined statistics and trends of your movie-watching groups.

---

🛠️ Tech Stack

Daccotta is built using a modern and efficient tech stack to provide the best experience for users:

• Frontend: React.js
• Styling: TailwindCSS + shadcn etc.
• Data Fetching & State Management: TanStack Query + axios.
• Backend: Node.js + Express
• Package manager: pnpm (workspaces)
• Database: MongoDB Atlas (Cloud)
• Authentication: better-auth (email + password)

---

🚀 Getting Started

To set up and run Daccotta locally, follow the steps below:

🗂️ Setting Up Daccotta Repository

1. Clone the repository to your local machine:

   git clone https://github.com/daccotta-org/daccotta.git

2. Navigate to the project directory:

   cd daccotta

Installing Node.js + pnpm

Daccotta uses Node.js 22+ and pnpm workspaces for the client and server.

For macOS:

1. Install Node.js 22 (via nvm or nodejs.org).

2. Enable pnpm with Corepack:

   corepack enable
   corepack prepare pnpm@10.4.1 --activate

For Windows:

1. Install Node.js 22 from nodejs.org.

2. In PowerShell (or your terminal):

   corepack enable
   corepack prepare pnpm@10.4.1 --activate

🖥️ Frontend-Only Setup

If you only want to contribute to the frontend, follow these steps:

1. From the repo root, install workspace dependencies:

   pnpm install

2. Create a .env file in the client directory:

   VITE_ACCESS_KEY=your_tmdb_key
   VITE_API_BASE_URL=https://your-backend-url
   

3. You still need to setup your tmdb account and get an API key from them , its free and takes just 5 mins. refer to their docs. if you still face any issues contact to the maintainers of the repo we may be able to provide you with a test key.

4. Start the frontend development server:

   pnpm --filter client dev

5. Your frontend should now be running at http://localhost:5173.

🗂️ Setting Up Full Stack Daccotta (Client & Server)

If you're setting up the full stack, continue with these steps:

refer to .env.example files for env variables

1. From the repo root, install all workspace dependencies:

   pnpm install

2. Setting Up MongoDB Atlas:

   • Visit the MongoDB Atlas website and sign up for an account.
   • After logging in, create a new project, then click on Build a Cluster to set up a free-tier cluster.
   • Once your cluster is ready, click Connect, then choose Connect your application.
   • Copy the connection string provided. It will look something like this:

     mongodb+srv://<username>:<password>@cluster0.mongodb.net/myFirstDatabase?retryWrites=true&w=majority

   • Replace <username>, <password>, and myFirstDatabase with your actual MongoDB Atlas username, password, and the database name you wish to use.
   • Set the MONGO_URL in server/.env:

     MONGO_URL=mongodb+srv://<username>:<password>@cluster0.mongodb.net/daccotta?retryWrites=true&w=majority

3. Setting Up Auth (better-auth):

   Auth is self-hosted via better-auth (email + password). No Firebase project is required.

   In server/.env:

   BETTER_AUTH_SECRET=   # openssl rand -base64 32
   BETTER_AUTH_URL=http://localhost:8080
   CLIENT_URL=http://localhost:5173
   MONGO_URL=...

   In client/.env:

   VITE_ACCESS_KEY=your_tmdb_key
   VITE_API_BASE_URL=http://localhost:8080

4. Running the Full Stack Project:

   • From the root directory, start both frontend and backend with:

     pnpm start:all

5. Your full stack app should now be running! 🎉 Open your browser and go to http://localhost:5173.

---

Our Valuable Contributors ❤️✨

Contributor	Contributor	Contributor	Contributor
AshuKr22 👨‍💻	Sid 👨‍💻	Shubham Agarwal 👨‍💻	Mehul 👨‍💻
Alolika 👩‍💻	Daccotta 👨‍💻	Knighthinata 👨‍💻	Sourabh 👨‍💻
Samyak Aditya 👨‍💻	Harsh Bhar 👨‍💻	Amit Bora 👨‍💻	Mukul Kundu 👨‍💻
Mayur 👨‍💻	Ikki Ocean 👨‍💻	Dhruv Pahuja 👨‍💻	Say Het 👨‍💻
Dev Rish 👨‍💻	Vaibhav 👨‍💻	Trijal Kaushik 👨‍💻

Contributing

We'd love your help to make Daccotta even better! If you're interested in contributing, please read CONTRIBUTION GUIDE.

---

Contact

Project Admins⚡

ASHU KUMAR

SIDDHARTH GUPTA

Feel free to reach out to us for any queries or suggestions: Email: daccotta.pvt@gmail.com Website: daccotta.com

---

⚠️ Attribution

Daccotta uses TMDB and the TMDB APIs but is not endorsed, certified, or otherwise approved by TMDB.

---

Made with ❤️ by movie lovers for movie lovers!

---