Skip to content

itsshiva78/whispers-within

Repository files navigation

Whispers Within Logo

🤫 Whispers Within

The Ultimate Anonymous Messaging & Feedback Platform

Next.js TypeScript Tailwind MongoDB Cashfree Vercel


Whispers Within is a modern, full-stack anonymous messaging application that lets users receive honest, unfiltered feedback from anyone, anywhere. Featuring a beautifully crafted dark-mode glassmorphic UI, robust serverless architecture, and a highly viral "Identity Reveal" payment gateway powered by Cashfree!


📸 Screenshots

(Add your images here! Simply replace link_to_your_image with an actual screenshot URL, or drag-and-drop your screenshots directly into GitHub!)

Landing Page User Dashboard
Landing Page User Dashboard
Create Identity (Sign Up) Confession Wall
Sign Up Page Confession Wall

✨ Viral Features

  • 🎭 Anonymous Messaging: Generate a unique, shareable profile link (/u/username) to receive secret messages instantly without the sender needing an account.
  • 💳 Premium Identity Reveal: Monetize curiosity! Users can securely pay (via Cashfree Payment Gateway) to unlock the hidden identity and device metadata of the sender.
  • 🤖 Gemini AI Integration: Sender has writer's block? Built-in AI auto-generates creative, deep, or funny anonymous messages with one click.
  • 🔐 Bulletproof Authentication: Offers standard Email/Password sign-up as well as frictionless Google OAuth login via NextAuth v4.
  • ✉️ OTP Email Verification: Secure domain email verification using magic 6-digit codes delivered flawlessly via Resend.
  • 📱 Mobile-First & Responsive: A flawless, premium, app-like experience across Mobile, Tablet, and Desktop using Tailwind & Framer Motion.
  • 🎛️ Private Dashboard: Pause incoming whispers, delete old messages, reveal identities, and easily share your link to Instagram or Snapchat.
  • 🧱 Confession Wall: A public, auto-scrolling wall highlighting the best messages.

🚀 Live Demo

Experience Whispers Within here!


🛠️ Tech Stack & Architecture

  • Frontend: Next.js 14 App Router, React 18, Tailwind CSS, Shadcn UI, Embla Carousel.
  • Backend: Next.js Serverless API Routes, Node.js edge runtime.
  • Database: MongoDB & Mongoose ORM.
  • Authentication: NextAuth (Credentials & Google Providers), bcrypt.js.
  • Payments: Cashfree PG Node.js SDK (cashfree-pg) & Client SDK (@cashfreepayments/cashfree-js).
  • Emails: Resend API & React Email Templates.
  • Validation: Zod & React Hook Form.

💻 Getting Started Locally

Getting the app running on your local machine is incredibly simple.

1. Clone the repository & Install Dependencies

git clone https://github.com/itsshiva78/whispers-within.git
cd whispers-within
npm install

2. Set up Environment Variables

Create a .env file in the root directory and add all the required keys:

# Application
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your_super_secret_generated_string

# Database
MONGODB_URI=your_mongodb_connection_string

# Authentication & Emails
GOOGLE_CLIENT_ID=your_google_oauth_client_id
GOOGLE_CLIENT_SECRET=your_google_oauth_secret
RESEND_API_KEY=your_resend_api_key

# Generative AI (Crucial for auto-suggestions)
GEMINI_API_KEY=your_gemini_api_key

# Payments (Cashfree Identity Reveal)
CASHFREE_APP_ID=your_cashfree_app_id
CASHFREE_SECRET_KEY=your_cashfree_secret_key
CASHFREE_ENVIRONMENT=SANDBOX # Toggle to PRODUCTION when live

3. Run the Development Server

npm run dev

Open http://localhost:3000 with your browser to experience the magic locally!


🚢 Production Deployment

This project's serverless architecture is heavily optimized to be deployed instantly on Vercel:

  1. Push your repository to GitHub.
  2. Import the project in Vercel.
  3. Add all your environment variables in the Vercel Dashboard (Project Settings -> Environment Variables).
  4. Important: Ensure NEXTAUTH_URL is set to your actual live Vercel domain (e.g., https://www.whispers-within.in) and CASHFREE_ENVIRONMENT is set to PRODUCTION.
  5. Click Deploy.

Built with ❤️ by Shiva

If you like this project, please consider leaving a ⭐ on the repository!

About

Whispers Within is an anonymous messaging web app where users create a profile, share a unique link, and receive private, anonymous messages through a secure, modern interface.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors