A fan-made recreation of the VALORANT Agent Browser visual design introduced in Patch 5.03 on August 9, 2022 (official patch notes). Built with Next.js, React, and TypeScript, it presents playable agents with their portraits, roles, abilities, and agent-specific background gradients.
- Agent browser: Highlights the selected agent and displays their role and ability information.
- Circular navigation: Browse the agent roster using previous/next buttons or the mouse wheel.
- Scrollable agent strip: Select agents from a carousel of up to 13 visible icons.
- Dynamic backgrounds: The background gradient changes to match the selected agent.
- Live agent data: Fetches playable-agent information from the VALORANT API.
- Next.js 16 and React 18
- TypeScript
- Tailwind CSS
- Material UI Icons
- VALORANT API for agent data
- Node.js and npm
-
Clone the repository:
git clone https://github.com/sans-script/valorant-agents-showcase.git cd valorant-agents-showcase -
Install dependencies:
npm install
-
Start the development server:
npm run dev
-
Open http://localhost:3000 in your browser.
The app requests agent data from https://valorant-api.com/v1/agents?isPlayableCharacter=true, so loading the roster requires an internet connection and the API to be available.
.
├── app/ # Next.js app entry point and global styles
├── components/
│ ├── AgentSlider.tsx # Main agent carousel and navigation controls
│ ├── AgentInfo.tsx # Selected agent's role and ability information
│ └── SelectedAgent.tsx # Main selected-agent presentation
├── hooks/
│ ├── useAgents.ts # Agent data loading state
│ ├── useAgentNavigation.ts # Circular selection and navigation logic
│ └── useMouseWheel.ts # Mouse-wheel navigation handler
├── lib/
│ └── fetchAgents.ts # VALORANT API request and agent data type
├── utils/
│ └── gradient.ts # Background gradient utility
└── fonts/ # Custom VALORANT-inspired fonts
- State and effects:
useStateanduseEffectmanage fetched agent data and selection state. - Custom hooks: Data loading, navigation, and mouse-wheel handling are separated into reusable hooks.
- Component composition: The slider, selected-agent view, and agent information panel have distinct responsibilities.
- Event handling: Button clicks and mouse-wheel input move through the roster.
- Dynamic rendering and styling: Agent data drives the displayed content, selected-item styling, and background gradient.
This is an unofficial fan project made for learning and UI experimentation. VALORANT and its associated names, artwork, and other assets belong to their respective owners. This project is not affiliated with or endorsed by Riot Games.
