https://github.com/sethshivam11/sociial
An engaging social media app where you can share stories, explore videos, and connect with people effortlessly. With features like interactive posts, suggestions, infinite scrolling, audio/video calls, real-time messages and much more designed for a seamless user-experience.
https://github.com/sethshivam11/sociial
audio-call camera-api cloudinary emoji-mart firebase-messaging location-api lucide-react nextjs qrcode react-redux react-rnd react-sketch-canvas redux-toolkit shadcn-ui socket-io-client tailwindcss typescript usehooks-ts video-call zod
Last synced: about 1 month ago
JSON representation
An engaging social media app where you can share stories, explore videos, and connect with people effortlessly. With features like interactive posts, suggestions, infinite scrolling, audio/video calls, real-time messages and much more designed for a seamless user-experience.
- Host: GitHub
- URL: https://github.com/sethshivam11/sociial
- Owner: sethshivam11
- Created: 2024-06-07T12:53:55.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2026-02-10T05:55:51.000Z (about 2 months ago)
- Last Synced: 2026-02-10T10:52:54.536Z (about 2 months ago)
- Topics: audio-call, camera-api, cloudinary, emoji-mart, firebase-messaging, location-api, lucide-react, nextjs, qrcode, react-redux, react-rnd, react-sketch-canvas, redux-toolkit, shadcn-ui, socket-io-client, tailwindcss, typescript, usehooks-ts, video-call, zod
- Language: TypeScript
- Homepage: https://sociial.vercel.app/home
- Size: 19.2 MB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![LinkedIn][linkedin-shield]][linkedin-url]
Sociial
An engaging social media app where you can share stories, explore videos, and connect with people effortlessly. With features like interactive posts, suggestions, infinite scrolling, audio/video calls, real-time messages and much more designed for a seamless user-experience.
Explore the docs »
View Demo
·
Report Bug
·
Request Feature
Table of Contents
## About The Project
[![Product Name Screen Shot][product-screenshot]](https://sociial.vercel.app/home)
### Built With
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
## Getting Started
### Installation
1. Clone the repo
```sh
git clone https://github.com/sethshivam11/sociial.git
```
2. Install NPM packages
```sh
npm install
```
3. Enter your environment variables in `.env.local`
```bash
NEXT_PUBLIC_LINK=YOUR_LOCALHOST_URL
BACKEND_URL=YOUR_BACKEND_URL
NEXT_PUBLIC_SOCKET_URL=YOUR_BACKEND_URL
NEXT_PUBLIC_FIREBASE_VAPID_KEY=YOUR_FIREBASE_VAPID_KEY
NEXT_PUBLIC_FIREBASE_API_KEY=YOUR_FIREBASE_API_KEY
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=YOUR_FIREBASE_AUTH_DOMAIN
NEXT_PUBLIC_FIREBASE_PROJECT_ID=YOUR_FIREBASE_PROJECT_ID
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=YOUR_FIREBASE_STORAGE_BUCKET
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=YOUR_FIREBASE_MESSAGING_SENDER_ID
NEXT_PUBLIC_FIREBASE_APP_ID=YOUR_FIREBASE_APP_ID
NEXT_PUBLIC_MAPS_API_KEY=YOUR_MAPS_API_KEY
```
4. Change git remote url to avoid accidental pushes to base project
```sh
git remote set-url origin github-username/repo-url
git remote -v # confirm the changes
```
## Usage
You can use the project by visiting https://sociial.vercel.app/home
For API Documentation visit https://documenter.getpostman.com/view/37731620/2sAY4rGR2L
For backend code visit https://github.com/sethshivam11/social-media-backend
## 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. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'feat: Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
### Top contributors:
## Contact
Shivam - [@sethshivam11](https://x.com/sethshivam11) - sociial@gmail.com
Project Link: [https://github.com/sethshivam11/sociial](https://github.com/sethshivam11/sociial)
[contributors-shield]: https://img.shields.io/github/contributors/sethshivam11/sociial.svg?style=for-the-badge
[contributors-url]: https://github.com/sethshivam11/sociial/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/sethshivam11/sociial.svg?style=for-the-badge
[forks-url]: https://github.com/sethshivam11/sociial/network/members
[stars-shield]: https://img.shields.io/github/stars/sethshivam11/sociial.svg?style=for-the-badge
[stars-url]: https://github.com/sethshivam11/sociial/stargazers
[issues-shield]: https://img.shields.io/github/issues/sethshivam11/sociial.svg?style=for-the-badge
[issues-url]: https://github.com/sethshivam11/sociial/issues
[license-shield]: https://img.shields.io/github/license/sethshivam11/sociial.svg?style=for-the-badge
[license-url]: https://github.com/sethshivam11/sociial/blob/master/LICENSE.txt
[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&colorB=555
[linkedin-url]: https://linkedin.com/in/sethshivam11
[product-screenshot]: https://sociial.vercel.app/hero-light.png