Skip to content


Repository files navigation

XIV Bars – A Final Fantasy XIV Cross Hotbar Layout Planner

Welcome to XIV Bars! This is the source code for the Final Fantasy XIV (FFXIV) Cross Hotbar (XHB) planning tool. This is a passion project created for the purpose of serving the FFXIV community who may have use for a way to port hotbar layouts from the web into the game. It is built in NextJS and is continually being updated.

Table of Contents

How to Contribute

This project is updated frequently with fixes and new features. I kind of use this project as a space to try new things with javascript and web design, so there may be some lack of structure when updates are deployed live.

Reporting Issues

  1. You can submit bug reports from the Issues page.
  2. Make sure that the issue you're submitting doesn't already exist.
  3. Include step-by-step instructions on how to reproduce, as well as the operating system (OSX, Windows, etc.) and browser (Chrome, Firefox, etc.) you're using when encountering the issue.

Requesting Features

Submit and discuss feature requests from the Feature Requests page.

Contributing Code

Find an Issue to Work On

If you're interested in contributing code, take a look at open issues and create a pull request that addresses it. I'll review when I get the chance, but please be patient.


If you find this tool helpful, please donate. Donations go towards keeping the app servers and other resources up so that this tool is available to everyone for free.

Setting up a Dev Environment



The .env.example file contains all the environment variables used by the app. Copy it into the .env file.

> cp ./.env.example ./.env


To be able to authenticate with the local app, you'll need to set it up with Discord (OAuth2 Documentation).


Database URL

The postgresql database url.


Running the app

Install dependencies

> yarn install

Fetch and compile static data from XIVAPI

> yarn build:data

Running the app locally

> yarn dev

Once the app is running in development mode, open http://localhost:3000 to view it in the browser.

Running Tests

> yarn test


The source code for the Final Fantasy XIV W Cross Hotbar (WXHB) Planning and Simulation Tool built in NextJS.