Skip to content

Repository files navigation

🎯 RankMaster — Tier List Maker

rankmaster

🧠 About the Project

RankMaster is a powerful and intuitive Tier List Maker — a web tool that lets users visually rank and organize items into customizable tiers, very similar to the popular online platform TierMaker.

Tier lists are a common way to represent preferences or comparative rankings, often used for game characters, movies, products, food, music, or anything else you want to evaluate. RankMaster gives users a clean drag-and-drop interface that makes creating these visual rankings easy, fast, and fun — all directly in the browser without backend servers.

✨ Features

  • 🧲 Drag & Drop Ranking Easily move items between tiers with smooth interactions.

  • 🎨 Customizable Tiers Edit tier labels, change colors, reorder tiers, or delete them instantly.

  • Fast & Lightweight Built with Vite for blazing-fast development and builds.

  • 🎞 Smooth Animations Powered by Framer Motion for polished UI transitions.

  • 🧩 Component-based Architecture Clean, readable, and maintainable React structure.

  • 🌗 Modern UI Ready Designed with Tailwind-style utility classes and dark-mode compatibility.


🛠 Tech Stack

  • React 19
  • TypeScript
  • Vite
  • Framer Motion
  • Lucide Icons
  • @dnd-kit (Drag & Drop)

📁 Project Structure

.
├── App.tsx
├── index.tsx
├── index.html
├── components/
│   ├── TierRow.tsx
│   ├── ImagePool.tsx
│   └── RandomSelector.tsx
├── types.ts
├── metadata.json
├── vite.config.ts
├── tsconfig.json
└── package.json

🚀 Getting Started (Docker – Recommended)

No local Node.js installation required.

1️⃣ Build & Run (Development Mode)

docker compose up --build 

Then open:

http://localhost:3000

✔ Hot Reload enabled ✔ Zero local dependencies ✔ Clean Fedora / Linux friendly setup


🏗 Production Build (Optional)

npm run build
npm run preview

Preview will be available at:

http://localhost:3000

🧠 Key Design Decisions

  • React Portal for Modals Ensures popups always render above all UI layers.

  • Local State Driven UI No unnecessary global state or over-engineering.

  • Strict Type Safety Fully typed data models for tiers and items.


📄 License

MIT License — free to use, modify, and distribute.


🤝 Contributions

Pull requests, ideas, and improvements are welcome! Feel free to fork the project and build your own ranking system.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages