Skip to content

SUNSET-Sejong-University/roastivator

 
 

Repository files navigation

🔥 Roastivator - GitHub Profile Roaster

A brutally honest GitHub profile analyzer that roasts developers based on their repositories, commit messages, and questionable emoji usage.

📁 Project Structure

roastivator/
├── src/
│   ├── app/              # Next.js App Router (routes & layouts only)
│   │   ├── api/          # API routes
│   │   ├── page.tsx      # Homepage
│   │   ├── layout.tsx    # Root layout
│   │   └── not-found.tsx # 404 page
│   ├── components/       # Reusable React components
│   │   ├── providers/    # App providers & error boundaries
│   │   ├── ui/          # Reusable UI components  
│   │   └── github/      # GitHub-specific components
│   ├── hooks/           # Custom React hooks
│   ├── lib/             # Business logic & utility classes
│   ├── utils/           # General utility functions
│   ├── types/           # TypeScript definitions
│   └── constants/       # Configuration & constants
├── public/              # Static assets
├── docs/                # Documentation
└── ...config files      # Configuration files

✨ Features

  • Smart Analysis: Analyzes your GitHub profile, repositories, and commit history
  • Brutal Honesty: Get roasted based on your coding habits and contribution patterns
  • Commit Message Shaming: Special attention to terrible commit messages like "fix", "update", and "oops"
  • Emoji Crime Detection: Identifies overuse of emojis in professional commits
  • Beautiful UI: Modern, minimalistic design with smooth animations
  • Easter Eggs: Special treatment for famous developers
  • Demo Mode: Try it out with pre-selected GitHub accounts

🚀 Quick Start

  1. Install dependencies:

    npm install
  2. Run the development server:

    npm run dev
  3. Open http://localhost:3000 in your browser

  4. Enter a GitHub username and prepare to be roasted! 🔥

🎮 Keyboard Shortcuts

  • Ctrl + Enter: Roast the entered username
  • Esc: Reset to input screen (when viewing results)

🛠️ Built With

  • Next.js 15 - React framework with App Router
  • React 19 - Latest React with concurrent features
  • TypeScript - Type safety and better developer experience
  • TailwindCSS - Utility-first CSS framework
  • Framer Motion - Smooth animations and transitions
  • Lucide React - Beautiful, consistent icons
  • GitHub API - Real-time repository and user data

🎯 Roasting Categories

  1. Overall Profile: Account age, repository count, follower ratios
  2. Commit Messages: Detection of lazy messages like "fix", "update", "WIP"
  3. Contribution Patterns: Activity levels, repository quality, naming conventions
  4. Emoji Usage: Professional vs. personal communication analysis

⚠️ Disclaimer

This tool is for entertainment purposes only. Results may cause emotional damage. Proceed with thick skin and a sense of humor!

🤝 Contributing

Found a bug or want to add more roasting algorithms? Pull requests welcome!

📜 Credits

Designed and Developed by Azizbek Arzikulov

📄 License

MIT License - Feel free to roast responsibly.

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 95.3%
  • JavaScript 4.0%
  • CSS 0.7%