A modern social platform built for seamless sharing, interaction, and connection.
Postly is a full-stack social media platform built with production-grade tooling. Users can create posts, interact with others, upload media, and build their presence — all wrapped in a fast, responsive, accessible interface.
Currently live with 150+ active users, real-time-like interactions, and continuous feature development.
| Web | Mobile | Profile |
|---|---|---|
 |
 |
 |
- Secure sign-in via Clerk with Google and GitHub OAuth
- Protected routes and persistent session handling
- Create, publish, like, and reply to posts
- Share posts externally
- View profiles and posts from other users
- Smooth, real-time-like interactions
- Image and file uploads via UploadThing
- Secure, scalable upload pipeline
- Clean interface built with Shadcn UI and Radix UI
- Fully responsive across all screen sizes
- Fluid animations powered by Framer Motion
- Accessible components throughout
- Privacy-friendly usage insights via Vercel Analytics
| Layer | Technologies |
|---|---|
| Frontend | Next.js 15, React 19, TypeScript, Tailwind CSS |
| UI Components | Shadcn UI, Radix UI, Framer Motion, Lucide React |
| Backend | Next.js App Router, Server Actions, API Routes |
| Database | MongoDB, Mongoose |
| Auth | Clerk, OAuth (Google, GitHub) |
| Forms | React Hook Form, Zod |
| Uploads | UploadThing |
| Analytics | Vercel Analytics |
├── app/ # Next.js App Router — pages and layouts
├── components/ # Reusable UI components
├── lib/ # Utility functions and helpers
├── models/ # Mongoose schemas and models
├── actions/ # Server actions for backend logic
└── styles/ # Global styles and Tailwind config
- Node.js 18+
- MongoDB URI (Atlas or local)
- Clerk account
- UploadThing account
1. Clone the repository
git clone https://github.com/Kaushalendra-Marcus/Postly.git
cd Postly2. Install dependencies
npm install3. Configure environment variables
Create a .env.local file in the root directory:
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=
MONGODB_URI=
UPLOADTHING_SECRET=
UPLOADTHING_APP_ID=
NEXT_PUBLIC_APP_URL=4. Start the development server
npm run devVisit http://localhost:3000
- Follow / unfollow system
- Notifications
- Post discovery and explore feed
- Progressive Web App (PWA) support
- Performance optimizations
Contributions are welcome. Please open an issue first to discuss what you'd like to change, then submit a pull request against the main branch.
Distributed under the MIT License. See LICENSE for more information.
Built by Kaushalendra Singh