Skip to content

Repository files navigation

ArcKits

Weapon loadout builder and advisor for Arc Raiders. View the live website here.


Deploy React TypeScript Vite Tailwind CSS


ArcKits is a static single-page app for planning weapon loadouts in Arc Raiders. Pick a weapon, equip mods across attachment slots, and see stat changes and crafting costs update in real time. The Weapon Advisor recommends optimal weapon pairings for your scenario — no account, no backend, no ads.

Features

  • Weapon Browser — all weapons organized by ammo type (Light, Medium, Heavy) with stats, DPS, and range band info
  • Mod Builder — attach mods to each slot and see cumulative stat bonuses and crafting costs update live
  • Goal Presets — apply curated builds for common goals: Fix, Budget, Recoil, Stealth, PvP, ARC penetration
  • Shareable URLs — every build is encoded in the URL; copy and share directly
  • Weapon Advisor — filter by location, squad size, engagement range, and rarity budget to get ranked weapon pairing recommendations with synergy tags
  • Dark / Light Mode — follows OS preference, persists across sessions

Getting Started

Prerequisites: Node.js 20+

npm install
npm run dev       # Dev server at http://localhost:5173/arc-kits/
npm run build     # TypeScript check + production build → dist/
npm run preview   # Serve production build locally

Tech Stack

Tool Version
React 19
TypeScript 5.9
Vite 7
Tailwind CSS 4

Project Structure

src/
  App.tsx              — Root component, tab routing
  data/                — Hardcoded game data (weapons, mods, presets, advisor config)
  hooks/               — Business logic (builder state, cost, effects, URL sync, theme)
  advisor/engine/      — Deterministic weapon pairing recommendation engine
  components/          — UI components organized by feature domain
    layout/            — Header, nav
    weapons/           — Weapon picker
    builder/           — Mod builder and stat display
    advisor/           — Advisor page, filters, results
    shared/            — Reusable leaf components

See CLAUDE.md for full architecture detail, type system documentation, and instructions for adding new game content.

Deployment

Automatically deploys to GitHub Pages on every push to master via .github/workflows/deploy.yml.

Adding Game Content

Weapons, mods, presets, advisor locations, and scoring weights are all in src/data/. See the "How to Add Game Content" section in CLAUDE.md for step-by-step instructions on each content type.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages