Skip to content

Latest commit

Β 

History

34 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸŽ“ MRCET Confessions

A modern, full-stack anonymous confession platform built with Next.js 15, featuring real-time interactions, secure authentication, and a beautiful UI. Perfect for college communities to share thoughts anonymously.

✨ Key Features

  • πŸ” Secure Authentication - Google OAuth integration with NextAuth.js
  • πŸ“ Anonymous Posts - Create confessions with optional image uploads (Cloudinary)
  • ❀️ Real-time Interactions - Like and comment on posts instantly
  • 🎨 Modern UI - Beautiful animations with Framer Motion & NextUI components
  • ⚑ Server Actions - Fast, optimized data fetching with Next.js 15
  • πŸ—„οΈ Database - PostgreSQL with Prisma ORM for type-safe queries
  • πŸ“± Responsive Design - Tailwind CSS for mobile-first experience
  • 🎭 Animated Components - Sparkles, spotlight effects, and smooth transitions

πŸ› οΈ Tech Stack

Frontend:

  • Next.js 15 (App Router)
  • React 18 + TypeScript
  • Tailwind CSS + DaisyUI
  • Framer Motion
  • NextUI Components
  • Lucide Icons

Backend:

  • Next.js API Routes
  • NextAuth.js (Google OAuth)
  • Prisma ORM
  • PostgreSQL Database
  • Cloudinary (Image hosting)

Tools:

  • TypeScript
  • ESLint
  • React Hot Toast

πŸš€ Quick Start

Prerequisites

  • Node.js 18+ installed
  • PostgreSQL database
  • Google OAuth credentials
  • Cloudinary account

1. Clone the Repository

git clone https://github.com/abdulbaqui17/mrcet-confession.git
cd mrcet-confession

2. Install Dependencies

npm install

3. Environment Setup

Create a .env file in the root directory:

DATABASE_URL="postgresql://user:password@localhost:5432/mrcet_confessions"
GOOGLE_CLIENT_ID="your_google_client_id"
GOOGLE_CLIENT_SECRET="your_google_client_secret"
NEXTAUTH_SECRET="your_nextauth_secret"
NEXTAUTH_URL="http://localhost:3000"

4. Database Setup

npx prisma migrate deploy
npx prisma generate

5. Run Development Server

npm run dev

Visit http://localhost:3000 to see the app.

πŸ“¦ Fork & Contribute

Forking

  1. Click the Fork button at the top right of this repository
  2. Clone your forked repository
  3. Create a new branch: git checkout -b feature/your-feature
  4. Make your changes and commit: git commit -m "Add feature"
  5. Push to your fork: git push origin feature/your-feature
  6. Create a Pull Request

πŸ“‚ Project Structure

β”œβ”€β”€ prisma/              # Database schema & migrations
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/            # Next.js 15 app router pages
β”‚   β”œβ”€β”€ components/     # Reusable React components
β”‚   β”œβ”€β”€ lib/            # Auth & utility functions
β”‚   β”œβ”€β”€ server/         # Server actions
β”‚   └── types/          # TypeScript types
β”œβ”€β”€ public/             # Static assets
└── tailwind.config.ts  # Tailwind configuration

🎯 What Makes This Project Stand Out

  • Modern Stack: Uses Next.js 15 with latest React Server Components
  • Type Safety: Full TypeScript implementation with Prisma
  • Real-world Features: Authentication, database relations, file uploads
  • Production Ready: Includes migrations, error handling, and optimization
  • Best Practices: Server actions, proper data fetching, and security measures
  • Beautiful UI: Professionally designed with modern animations

πŸ“Έ Screenshots & Demo

The project includes:

  • Landing page with hero section, features, and testimonials
  • Authentication flow with Google OAuth
  • Post creation with image upload
  • Interactive feed with likes and comments
  • Responsive design for all devices

🀝 Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

πŸ“„ License

This project is open source and available under the MIT License.


Built with ❀️ by Abdul Baqui | GitHub

About

πŸŽ“ Anonymous confession platform for MRCET students. Built with Next.js 15, NextAuth, Prisma & PostgreSQL. Features real-time likes/comments, Google OAuth, image uploads, and beautiful animations. A modern full-stack app showcasing server actions and type-safe development.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages