KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #cli #codex #claude-code #dsh-plugin #mcp #react #agent #dsh #deepseek-harness

Roast_King

★ 43 Open GitHub ↗

Cosmic flex-roasting station. Submit your achievements and let the AntiGravity engine obliterate them with interactive physics, synthesized soundscapes, and stellar burns.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img src="public/banner.svg" alt="Roast King Banner" width="100%">

<a href="https://git.io/typing-svg">
 <img src="https://readme-typing-svg.demolab.com?font=Outfit&size=24&duration=3000&pause=1000&color=F472B6&center=true&vCenter=true&width=600&height=50&lines=🌌+Welcome+to+the+Roast+King+Station...;🔥+Ego-annihilating+roasts+on+demand...;🪐+Three+gravity-defying+burn+modes...;☄️+Brace+for+the+Meteor+Strike..." alt="Typing SVG" />
 </a>

<img src="https://img.shields.io/badge/React-19-%2361DAFB?style=for-the-badge&logo=react&logoColor=white" alt="React 19" />
 <img src="https://img.shields.io/badge/Vite-8-%23646CFF?style=for-the-badge&logo=vite&logoColor=white" alt="Vite 8" />
 <img src="https://img.shields.io/badge/Tailwind_CSS-v4-%2338B2AC?style=for-the-badge&logo=tailwindcss&logoColor=white" alt="Tailwind CSS v4" />
 <img src="https://img.shields.io/badge/Framer_Motion-physics-%2300F0FF?style=for-the-badge&logo=framer&logoColor=white" alt="Framer Motion" />
 <img src="https://img.shields.io/badge/Web_Audio-API-%239F7AEA?style=for-the-badge&logo=soundcharts&logoColor=white" alt="Web Audio API" />
 <img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge" alt="MIT License" />

<a href="https://venkatesh-0007.github.io/Roast_King/">Explore Live Station 🪐</a> |
 <a href="#-quick-start">Launch Locally 🚀</a> |
 <a href="#-cosmic-modes">Roast Intensities 🔥</a>

## 🌌 The Roast King Universe

> *"Got a big ego? We'll bring it back to Earth. Because in the grand scheme of the universe, you're still a nobody."*

**Roast King** is a futuristic, cosmic-themed flex roasting web application. Submit your achievements, career flexes, or life statistics, and watch our AntiGravity engine tear them to cosmic dust with gravity-defying burns. The application features three stages of cosmic intensity, reactive spacetime grid warping, fluid physics-based transitions, and synthesized space soundscapes.

## 🔥 Cosmic Modes

Roast King adapts its appearance, animations, and roasting severity through three planetary presets.

<table width="100%">
 <tr>
 <td width="33%" align="center">
 <h3>🌊 Gentle Orbit</h3>
 "Soft landing, friendly orbital jabs."
 A calm cyan planet with slow, soothing ripples. Perfect for sensitive egos and light-hearted jokes.
 </td>
 <td width="34%" align="center">
 <h3>☄️ Meteor Strike</h3>
 "Heavy impacts, visible craters."
 A hot purple planet surrounded by orbiting meteors. Unleashes fiery burns that leave permanent damage.
 </td>
 <td width="33%" align="center">
 <h3>🕳️ Black Hole</h3>
 "Not even light (or your dignity) escapes."
 A warping black sphere with a vibrant neon accretion disk. Absolute, ego-annihilating devastation.
 </td>
 </tr>
</table>

## 🪐 Interactive Features

- ⚛️ **Spacetime Grid Warping** — Hover over the interactive gravity core and watch the grid mesh warp and bend under your mouse coordinates, mimicking actual gravitational fields.
- 🧊 **Liquid Glass Interface** — The UI features premium iOS-inspired glassmorphism panels with rich backdrop blur filters, glowing border accents, and responsive hover highlights.
- 🎵 **Synthesized Soundscapes** — Driven entirely by the native **Web Audio API** (no bulky audio assets). Generates organic planetary hums, UI clicks, meteor swooshes, and black hole resonance on the fly.
- ⭐ **Starred Flex Archive** — Keep track of the best burns. Save roasts to your cosmic vault, persistent across browser sessions using `localStorage` caching.
- 📊 **Ego Damage Analytics** — Every roast calculates a dynamic Gravity Score, showing key stats like *Ego Damage*, *Burn Intensity*, and a visual gauge meter showing how badly you were scorched.

## 🛠️ Tech Stack

| Component | Technology | Purpose |
|---|---|---|
| **Core Framework** | **React 19** | Declarative component architecture & state scheduling. |
| **Bundler / Tooling** | **Vite 8** | Ultra-fast Hot Module Replacement & production bundling. |
| **Styling Engine** | **Tailwind CSS v4** | Modern utility-first styling with native CSS variables. |
| **Motion & Physics** | **Framer Motion** | Physics-based micro-interactions and transitions. |
| **Vector Assets** | **Lucide React** | Clean, responsive, and customizable SVG iconography. |
| **Visual FX** | **Canvas Confetti** | Dynamic celebration effects for mild/gentle achievements. |
| **Audio Synthesizer** | **Web Audio API** | Dynamic real-time browser synthesizer for interactive SFX. |

## 🚀 Quick Start

### 📋 Prerequisites

Make sure you have [Node.js](https://nodejs.org/) (v18 or higher) and npm installed.

### ⚙️ Installation

```bash
# Clone the repository
git clone https://github.com/venkatesh-0007/Roast_King.git
cd Roast_King

# Install project dependencies
npm install

# Start the dev server
npm run dev
```

The server will spin up on [http://localhost:5173/Roast_King/](http://localhost:5173/Roast_King/).

### 📦 Production Build

To create an optimized production bundle:

```bash
npm run build
```

Production output will be generated inside the `/dist` directory, fully prepared for static hosting platforms.

## 🏗️ Repository Blueprint

```
Roast_King/
├── .github/
│   └── workflows/
│       └── deploy.yml          # GitHub Pages CI/CD automation workflow
├── public/
│   ├── favicon.svg             # Application favicon
│   ├── icons.svg               # SVG Icon Spritesheet
│   ├── banner.svg              # Animated Header Banner
│   └── divider.svg             # Animated Section Dividers
├── src/
│   ├── components/
│   │   ├── CosmicBackground.jsx    # Starfield particle canvas background
│   │   ├── HistoryDrawer.jsx       # Saved roasts sidebar list
│   │   ├── InteractivePlanet.jsx   # Mouse-reactive gravity sphere canvas/SVG
│   │   ├── RoastForm.jsx           # Flexible user inputs and intensity toggles
│   │   ├── RoastResults.jsx        # Burn readout cards with gauge indicator
│   │   └── TrendingFlexes.jsx      # Ready-made presets for quick burning
│   ├── services/
│   │   ├── audio.js                # Web Audio API Synth Engine
│   │   └── roastEngine.js          # Client-side roasting and analytics generator
│   ├── App.jsx                     # Core application orchestrator
│   ├── index.css                   # Global styling reset & design systems
│   └── main.jsx                    # React mounting module
├── index.html                  # Core HTML file
├── vite.config.js              # Vite configuration with Tailwind CSS integration
├── package.json
└── LICENSE                     # MIT License
```

## 📝 License

Distributed under the **MIT License**. Check out the [LICENSE](./LICENSE) file for details.

🌌 Designed and Engineered by <a href="https://github.com/venkatesh-0007">Venkatesh</a> 
 No cosmic fields or gravity grids were harmed in the making of this station.

Roast_King

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README