A live version of the website is hosted at arcforge.org

Prerequisites

• Node.js 18+
• npm, yarn, pnpm, or bun

Installation

1. Clone the repository:

git clone https://github.com/wangyz1999/arcforge.git
cd arcforge

2. Install dependencies:

npm install

3. Run the development server:

npm run dev

4. Open http://localhost:3000 in your browser

Building for Production

npm run build
npm start

Code Style

• Prettier is configured and runs automatically on staged files via Husky + lint-staged when you make a commit.

Data Pipeline

The project includes Python scripts to scrape and process item data from the ARC Raiders wiki:

cd script
python run_pipeline.py

Tech Stack

• Framework: Next.js 16
• Language: TypeScript
• UI Library: React 19
• Styling: Tailwind CSS
• Graph Visualization: Cytoscape.js
• Icons: Font Awesome
• Data Source: ARC Raiders Wiki

Project Structure

arcforge/
├── app/                      # Next.js app directory
│   ├── api/                  # API routes
│   │   └── proxy-image/      # Image proxy for wiki thumbnails
│   ├── components/           # React components
│   ├── i18n/                 # Internationalization
│   │   └── translations/     # Translation files
│   │       ├── {lang}.json       # UI strings
│   │       └── items_{lang}.json # Item names
│   ├── layout.tsx            # Root layout
│   └── page.tsx              # Item database page
├── data/                     # JSON data files
│   ├── items_database.json   # Complete item data
│   ├── items_relation.json   # Item relationships for graph
│   └── names.txt             # Item name list
├── public/                   # Static assets
│   ├── logo.webp
│   └── ...
└── script/                   # Python data processing scripts
    ├── get_item_data_from_wiki.py
    ├── build_relation_graph.py
    ├── adjust_item_data.py
    └── run_pipeline.py

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

If you find this work helpful, please consider to star🌟 this repo. Thanks for your support!

License

This project is licensed under the MIT License - see the LICENSE file for details.

Made with ❤️ for the ARC Raiders community