Gw1builds
A lightweight sharing tool for Guild Wars 1 builds
Install / Use
/learn @gw1tools/Gw1buildsREADME
What is this?
GW1 Builds is a modern build sharing tool for a timeless legend. No downloads, no clunky UIs. Just builds you can share with a link.
Create your build in-game, paste the template code, add some notes, and share it with the world. That's it!
Features
Builder
- Paste skill template codes or pick skills manually with search
- Paste equipment template codes or configure armor, weapons, runes, and insignias individually
- Attribute-scaled skill descriptions show actual damage/duration at your build's level
- Build variants for alternative setups (anti-caster, budget, etc.)
- One-click copy for both skill and equipment codes
Team Builds
- Support for solo builds up to 12-player teams
- Duplicate slots for flexible team compositions
Sharing & Collaboration
- Private builds (hidden from search, shareable via direct link)
- Share drafts before publishing
- Collaborators can edit your builds with you
- Create new builds from existing ones as templates
Search
- Spotlight search (Cmd+K / Ctrl+K) for quick access
- Searches both user builds and 26,000+ PvX Wiki archives
Quality of Life
- Browse and copy builds without an account
- Create builds as a guest, sign up when ready to save
- Discord and email login options
- Dark theme and mobile friendly
- Feedback button for bugs and suggestions
Tech Stack
| Tech | Purpose | |------|---------| | Next.js 16 | React framework with App Router | | TypeScript | Type-safe JavaScript | | Tailwind CSS v4 | Utility-first styling | | Supabase | Database, auth, and storage | | TipTap | Rich text editor for build notes | | Vercel | Hosting and deployment | | Claude Code | AI-powered code companion |
Getting Started
# Clone the repository
git clone https://github.com/gw1tools/gw1builds.git
cd gw1builds
# Install dependencies
npm install
# Set up environment variables
cp .env.example .env.local
# Start development server
npm run dev
Open localhost:3000 to run it locally. You need to create your Supabase project and update the .env.local file with your Supabase credentials.
Project Structure
app/ → Pages, routes, and API endpoints
components/ → Reusable React components
lib/ → Utilities, services, and GW1 data
types/ → TypeScript type definitions
docs/PRD/ → Product requirement documents (some might be outdated, but I left them in to show the dev process)
.claude- Settings, Agents, Plugins and Commands for Claude Codeapp/(main)/- Main app pages (home, build details, create)app/api/- Server-side API routescomponents/ui/- Design system componentscomponents/build/- Build-specific componentscomponents/editor/- TipTap editor componentslib/gw/- GW1-specific utilities (template decoder, skill data)lib/supabase/- Database client and queries
Contributing
Found a bug or have an idea? Open an issue on GitHub. The more detail you provide, the easier it is to implement. Want to contribute code? Reach out via an issue first and we'll go from there.
Credits
A special thanks to:
- ArenaNet - For creating Guild Wars and so many wonderful memories. Reforged has been such a surprise and an inspiration to create this project.
- Guild Wars Wiki - The definitive resource for all things GW1.
- PvX Wiki - For years of build documentation and community knowledge. We hope to build a complementary tool for easier build sharing.
- TeamBuilder - For creating the original build sharing tool and all the amazing memories playing HA late at night.
- paw·ned² - For continuing the TeamBuilder legacy and for the profession icon font.
- build-wars - For the template decoder and skill data.
- Claude Code - For making this project possible. Without AI-assisted development, we wouldn't have had the time or resources to build this.
License
MIT - Free to use, modify, and share.
<p align="center"> <sub>Built with love and nostalgia for the Guild Wars 1 community</sub> </p>
