Groupy - Connect with Like-Minded People

This project is currently in development 🚀

Welcome to Groupy, a social networking platform designed to bring together individuals with shared interests, whether you're looking for a workout buddy, a study group, or a team to work on exciting projects. Groupy aims to make it easy for you to find and connect with others who share your passions.

Technologies Used

Groupy is built using the following technologies:

TurboRepo: A package manager facilitating dependency management for projects
Socket.io: Enabling real-time, bidirectional communication between web clients and servers, utilizing WebSockets or alternative transport mechanisms.
Express: Server-side logic and HTTP request handling for chat server.
Next.js: A popular React framework for building server-side rendered applications.
TypeScript: A typed superset of JavaScript that enhances code scalability and maintainability.
tRPC: A simple and fast way to create TypeScript API endpoints.
Redis: In-memory data structure store serving as a database, cache, and message broker, supporting various data structures and offering high performance and scalability.
Prisma with Supabase: Prisma is used as the ORM to interact with the database, and Supabase provides the backend-as-a-service platform.
Tailwind CSS: A utility-first CSS framework for rapidly styling the user interface.
NextAuth: Provides authentication support for Next.js applications.
Tanstack Query: A powerful data fetching and caching library for managing data in the application.
RecoilJS: A state management library for managing and sharing the application's global state.
Zod: A TypeScript-first schema validation library for data validation and sanitization.

Project Structure

packages/db_prisma: Contains Prisma ORM which is used to talk to PostgreSQL database.
apps/chatServer: This folder contains the chat server which is runs on express and socket.io.
apps/chatServer/utils: Consists of utility functions for chatServer.
apps/groupy/src/pages: This directory contains the Next.js pages used to structure the application's frontend.
apps/groupy/src/components: Inside this folder, you'll find the components that are utilized within the pages located in src/pages.
apps/groupy/public: This directory holds SVG files converted into TypeScript (tsx) files, as well as the fonts used throughout Groupy. It serves as a repository for static assets accessible to both the frontend and the backend.
apps/groupy/src/common: Contains a collection of functions that are shared between both the frontend and the backend for Groupy.
apps/groupy/src/utils: Consists of utility functions for Groupy.
apps/groupy/src/store: Contains Recoil states, which help manage the state of the React components efficiently.
apps/groupy/src/server: This directory is dedicated to the backend for Groupy. It contains backend APIs and a Prisma connector for interacting with the database. Server logic and API endpoints are implemented here.
apps/groupy/prisma: This folder contains Prisma migrations and a schema.prisma file. The schema.prisma file serves as the blueprint for the database models, defining their structure and relationships.

Completed Features

So far, the following features have been implemented in Groupy:

Creating Account: Users can sign up and create their accounts.
Updating Account Information: Users can edit and update their account details.
Creating Posts with Image Uploads: Users can create posts and upload images to share their interests.
Data Fetching and Caching: Data is efficiently fetched and cached using Tanstack Query to provide a seamless user experience.
Notifications Handling: Users receive notifications for important events.
Writing Comments for Posts: Users can comment on posts to engage in discussions.
Bandwidth-Saving Comment Loading: A limited number of comments are initially loaded per post, with dynamic loading of more comments as the user scrolls to optimize bandwidth usage.
Sending Friend Requests: Users can connect with others by sending friend requests.
Creating Groups: Users can create groups through posts and can toggle instant join option which lets other users join the group on a single click or sends notification to the group moderator if Instant join is set to false.
Live Chatting: Chat page is now available where users can see their joined groups and actively participate while chatting.

Planned Features

There are exciting features in the pipeline to enhance Groupy further:

Searching for Posts through Tags: Users will be able to filter posts based on tags to find specific groups of interest.
Group Moderation Options: Group moderators will be able to add or remove users from their group .

Getting Started

To run Groupy locally, follow these steps:

Clone the repository.
Install the required dependencies using npm install.
Run the command turbo db:generate to generate Prisma Client.
Rename the env.example file to .env.
Add the following keys and replace the values with your own:
- Replace DATABASE_URL with your postgresql database url
- Replace YOUR_NEXTAUTH_URL with the URL of your Next.js application where NextAuth should handle authentication.
- Replace YOUR_NEXTAUTH_SECRET with a random secret key for NextAuth. You can generate one using a tool like openssl rand -hex 32.
- Replace YOUR_SUPABASE_PROJECT_URL with the URL of your Supabase project.
- Replace YOUR_SUPABASE_PROJECT_ANON_KEY with the anonymous key for your Supabase project.
Requirements for chat-server
- Replace NEXT_PUBLIC_CHATSERVER_URL with the URL where chat-server is running at (For development : http://localhost:4000).
- Replace REDIS_PORT with port of your redis server.
- Replace REDIS_HOST with host data of your redis server.
- Replace REDIS_PASSWORD with the password of your redis server.
- Replace CS_PORT with the PORT number where you want to run your chat-server.
Run database migrations using npm run prisma-migrate.
Run the development server using npm run dev.

Contribution

Contributions to Groupy are welcome! If you'd like to contribute to the project, follow these steps:

Fork the repository and clone it to your local machine.
Run the project on your local machine, check the Getting Started section to setup the project.
Make your changes and test them thoroughly.
Commit your changes with clear and concise messages.
Push your changes to your forked repository.
Create a pull request detailing your changes and their purpose.

License

Groupy is licensed under the MIT License, which allows you to use, modify, and distribute the code freely.

Thank you for considering Groupy! Let's build a community where people can connect and thrive together. If you have any questions or feedback, please don't hesitate to reach out. Happy coding!

Hiperultimate / groupy