๐Ÿ”ฅ Roast Stack

A no-holds-barred Gen-Z AI that absolutely obliterates your tech stack with surgical precision and zero chill.

๐Ÿค” What is this?

Ever lay awake at night wondering if your tech stack is a walking red flag? Wonder no more. Roast Stack is an AI-powered roast generator that serves up hilariously savage burns for your choice of frameworks, databases, and questionable architectural decisions.

From your 2008 LAMP stack to that 37-microservice monstrosity you call "scalable," Roast Stack sees all, judges all โ€” and does not hold back.

๐Ÿš€ Features

  • ๐Ÿ”ฅ Multiple Roast Modes
    Choose your spice level: Mild Shade, Medium Petty, or Nuclear Devastation

  • โšก Lightning Fast
    Delivers roasts faster than your CI/CD breaks in production

  • ๐Ÿ“ฑ Fully Responsive
    Works on all screen sizes โ€” unlike your 2000-line homepage CSS

  • ๐Ÿง  AI-Powered Sass
    Roasts generated using Gemini API, trained in the ancient art of tech sarcasm

  • ๐Ÿ’พ Persistent Burn Storage
    Saves your roasts in localStorage, so you can reflect on your poor choices later

๐Ÿง  Built With

  • Frontend: React.js
  • Backend: Express.js
  • AI: Gemini API
  • Roast Energy: Pure Gen-Z chaos

๐Ÿ› ๏ธ Setup Instructions

๐Ÿ“ฆ Prerequisites

  • Node.js (v18+)
  • npm or yarn
  • A thick skin

๐Ÿงช Installation

  1. Clone this glorious repo:

    git clone <your-repo-url>
    cd roast-stack
    
  2. Install backend dependencies:

    cd backend
    npm install
    
  3. Install frontend dependencies:

    cd ../frontend
    npm install
    
  4. Add your Gemini API Key:

    cd ../backend
    cp .env.example .env
    # Edit the .env file and paste your Gemini API key
    
  5. Run the development servers:

    # Terminal 1 - Backend
    cd backend
    npm run dev
    

Terminal 2 - Frontend

cd frontend npm start


## ๐Ÿ—‚๏ธ Project Structure

roast-stack/ โ”œโ”€โ”€ frontend/ # React app (where the sass lives) โ”œโ”€โ”€ backend/ # Express.js API (home of the roast logic) โ”œโ”€โ”€ README.md # You're looking at it โ””โ”€โ”€ .gitignore


## ๐Ÿ”ฅ API Endpoint

- `POST /api/roast` โ€” Submit your tech stack and get roasted

**Request Body:**
```json
{
  "stack": "React, Firebase, Python, MongoDB"
}

Response:

{
  "roast": "Wow. A NoSQL database *and* Python backend? Are you trying to build a startup or summon Cthulhu?"
}

๐Ÿ‘€ Contributing

Found a bug? Think your roast game is hotter than ours? Drop a PR.
We can't guarantee we won't roast your code in return though. ๐Ÿ˜

๐Ÿ“„ License

MIT โ€” Because even cursed stacks deserve freedom.

Built by Saai Aravindh Raja & Aung Ye Thant Hein
Roasting responsibly since 2025

Built With

Share this project:

Updates