Chirp

The Emoji-Only Social Network built for Gen-Z.

       

 See it in Action  »

Introduction · Features · Tech Stack · Development Setup · Contributing

❄️ Introduction

Chirp is the emoji-only social app where vibes speak louder than words. No texts, no captions — just pure emotion in every post. Chirp lets you react, express, and connect without saying a thing. Say it all. Just Chirp it.

🔋  Features

•  📦   End-to-End TypeSafe APIs

•  🎚️   Rate Limiting per user

•  🗃️   Organized File and Folder Structure

•  🔑   Secure Authentication with OAuth Providers (Google & GitHub)

•  📱   Fully Responsive Design optimized for all devices

•  ☾   Light and Dark Mode

⚙️  Tech Stack

• tRPC - TypeSafe RPC

• Next.js – React Framework

• Upstash - Rate Limiting

• ShadCN UI – Component library

• Tailwind CSS – CSS

• TypeScript - TypeSafe JavaScript

• Zod - Schema Declaration & Validation Library

• Postgres - Database

• Prisma – ORM

• Clerk – Authentication

• Git – Versioning

• Vercel – Deployments

🖥️   Local Development

0. Prerequisites

   Make sure you have the following installed on your machine:

   • Git
   • Node.js (v20+)
   • Docker
   • bun (As a Package Manager)

1. Clone the repository:

   git clone https://github.com/yntpdotme/chirp.git

2. Navigate to the project directory:

   cd chirp

3. Install dependencies:

   bun install

4. Add Environment Variables:

   Create .env file in the root folder and copy paste the content of .env.sample

   cp .env.sample .env

   Update credentials in .env with your credentials.

5. Setup Database

   Start Postgres with Docker

   ./start-database.sh

6. Start the App:

   bun dev

   Visit  http://localhost:3000  to access your app.

🤝  Contributing

Contributions are always welcome!

See CONTRIBUTING.md for ways to get started.

🪪   License

Chirp is open-source under the MIT License. Feel free to learn, add upon, and share!