Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ccrsxx/twitter-clone
Twitter clone built in Next.js + TypeScript + Tailwind CSS using Cloud Firestore and Storage
https://github.com/ccrsxx/twitter-clone
firebase framer-motion headlessui nextjs react-hot-toast swr tailwindcss twitter-clone typescript
Last synced: 4 days ago
JSON representation
Twitter clone built in Next.js + TypeScript + Tailwind CSS using Cloud Firestore and Storage
- Host: GitHub
- URL: https://github.com/ccrsxx/twitter-clone
- Owner: ccrsxx
- License: mit
- Created: 2022-08-31T05:10:56.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-06-08T06:05:29.000Z (7 months ago)
- Last Synced: 2024-12-20T12:08:11.608Z (11 days ago)
- Topics: firebase, framer-motion, headlessui, nextjs, react-hot-toast, swr, tailwindcss, twitter-clone, typescript
- Language: TypeScript
- Homepage: https://twitter-clone-ccrsxx.vercel.app
- Size: 1.94 MB
- Stars: 822
- Watchers: 15
- Forks: 188
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Twitter clone built in Next.js + TypeScript + Tailwind CSS using Cloud Firestore and Storage
## Preview 🎬
https://user-images.githubusercontent.com/55032197/201472767-9db0177a-79b5-4913-8666-1744102b0ad7.mp4
## Features ✨
- Authentication with Firebase Authentication
- Strongly typed React components with TypeScript
- Users can add tweets, like, retweet, and reply
- Users can delete tweets, add a tweet to bookmarks, and pin their tweet
- Users can add images and GIFs to tweet
- Users can follow and unfollow other users
- Users can see their and other followers and the following list
- Users can see all users and the trending list
- Realtime update likes, retweets, and user profile
- Realtime trending data from Twitter API
- User can edit their profile
- Responsive design for mobile, tablet, and desktop
- Users can customize the site color scheme and color background
- All images uploads are stored on Firebase Cloud Storage
## Tech ðŸ›
- [Next.js](https://nextjs.org)
- [TypeScript](https://www.typescriptlang.org)
- [Tailwind CSS](https://tailwindcss.com)
- [Firebase](https://firebase.google.com)
- [SWR](https://swr.vercel.app)
- [Headless UI](https://headlessui.com)
- [React Hot Toast](https://react-hot-toast.com)
- [Framer Motion](https://framer.com)
## Development 💻
Here are the steps to run the project locally.
1. Clone the repository
```bash
git clone https://github.com/ccrsxx/twitter-clone.git
```
1. Install dependencies
```bash
npm i
```
1. Create a Firebase project and select the web app
1. Add your Firebase config to `.env.development`. Note that `NEXT_PUBLIC_MEASUREMENT_ID` is optional
1. Make sure you have enabled the following Firebase services:
- Authentication. Enable the Google sign-in method.
- Cloud Firestore. Create a database and set its location to your nearest region.
- Cloud Storage. Create a storage bucket.
1. Install Firebase CLI globally
```bash
npm i -g firebase-tools
```
1. Log in to Firebase
```bash
firebase login
```
1. Get your project ID
```bash
firebase projects:list
```
1. Select your project ID
```bash
firebase use your-project-id
```
1. At this point, you have two choices. Either run this project using the Firebase on the cloud or locally using emulator.
1. Using the Firebase Cloud Backend:
1. Deploy Firestore rules, Firestore indexes, and Cloud Storage rules
```bash
firebase deploy --except functions
```
1. Run the project
```bash
npm run dev
```
1. Using Firebase Local Emulator:
1. Install [Java JDK version 11 or higher](https://jdk.java.net/) before proceeding. This is required to run the emulators.
1. Set the environment variable `NEXT_PUBLIC_USE_EMULATOR` to `true` in `.env.development`. This will make the app use the emulators instead of the cloud backend.
1. At this point, you can run the following command to have a fully functional Twitter clone running locally:
```bash
npm run dev:emulators
```
> **_Note_**: When you deploy Firestore indexes rules, it might take a few minutes to complete. So before the indexes are enabled, you will get an error when you fetch the data from Firestore.
You can check the status of your Firestore indexes with the link below, replace `your-project-id` with your project ID: https://console.firebase.google.com/u/0/project/your-project-id/firestore/indexes
Optional:
- If you want to get trending data from Twitter API, you need to create a Twitter developer account and get your API keys. Then add your API keys to `.env.development`. I hope Elon Musk doesn't make this API paid 😅.
- If you want to make the user stats synced with the deleted tweets, you need to enable the Cloud Functions for Firebase. Then deploy the Cloud Functions.