https://github.com/jazzsequence/dnd-battle-tracker
A simple battle tracking system for Dungeons & Dragons written in React to track initiative and damage.
https://github.com/jazzsequence/dnd-battle-tracker
Last synced: about 2 months ago
JSON representation
A simple battle tracking system for Dungeons & Dragons written in React to track initiative and damage.
- Host: GitHub
- URL: https://github.com/jazzsequence/dnd-battle-tracker
- Owner: jazzsequence
- License: gpl-3.0
- Created: 2019-05-15T22:27:18.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2024-05-13T12:26:37.000Z (almost 2 years ago)
- Last Synced: 2025-07-18T07:40:39.968Z (8 months ago)
- Language: JavaScript
- Homepage: https://battletracker.jazzsequence.com
- Size: 3.02 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Battle Tracker ⚔️
[](https://github.com/jazzsequence/DnD-Battle-Tracker/releases/) [](https://github.com/jazzsequence/DnD-Battle-Tracker/blob/master/LICENSE) 
 
A simple battle tracking system for Dungeons & Dragons written in JavaScript to track initiative and damage.
[Visit battletracker.jazzsequence.com to check it out!](https://battletracker.jazzsequence.com)
## Description
I originally built this as an experiment after finishing [Wes Bos](https://github.com/wesbos)' [ES6 for Everyone](https://es6.io/) course to test my newfound JavaScript knowledge, put some of the things he talked about into practice, and to scratch my own itch; at the time I had just started running a D&D campaign for my kids.
After completing his [CSS Grid](https://cssgrid.io/) course, I decided to revisit this again to add some much-needed styling and layout.
Finally, continuing my JavaScript education, I took his [React for Beginners](https://reactforbeginners.com) course and rebuilt the entire thing in [React](https://reactjs.org/). This time, I refactored some things that were obviously missing, like the ability to retain character info after a battle is done. Finally, I put the whole thing on GitHub pages behind a custom subdomain ([battletracker.jazzsequence.com](https://battletracker.jazzsequence.com)).
## Roadmap
These are things I plan (or at least _hope_) to implement in the future.
* Accessibility
* A button that resets the character HP when the encounter is reset (currently HP can be reset by refreshing the page)
* Initiative randomizer (define initiative rather than entering rolled values)
* Attack options (each character/monster has their attacks & damage listed so dealing damage can be done by just clicking the button next to that attack type)
* Unit tests and linting
* More?
## Changelog
### 0.3.1
* fixed Firefox display bugs
### 0.3.0
* refactored entire codebase in React
* added true build and deploy process so app can be deployed as a single-page app (SPA)
* updated the character add and initiative order elements so characters are automatically ordered in their initiative order when they are added
* even more simplified html in the main `index.html` file (everything is served from within React components)
* added a new landing page which generates a unique guid where all your encounter information is stored in local storage.
* added a generic 404 page
* added `gh-pages` to handle deploying to GitHub pages
### 0.2.0
* added build tools
* added styling and layout
* some minor tweaks to initiative tracker and messages
* expanded readme
### 0.1.0
* Initial release