A character creator and interactive character sheet web application for the 5e ruleset of the most popular TTRPG in the world. See it live at rollforinit.herokuapp.com! Due to the nature of the hosting, you may need to refresh a few minutes after the initial load to get the full site.
Want to see what it's all about? Please see the demo here!
To run this application, create a file secret.env in the root directory following the guide below. Ensure MONGODB_URI_RULESET is populated with the ruleset from the 5e-database. Then, in the root directory, simply run:
npm install
npm run start
- JWT_SECRET
- A secret code such as a uuid.
- REDIS_URL
- Redis URI and protocol (similar to MONGODB_URI) for 5e-srd-api.
- No need to run local redis-server.
- MONGODB_URI
- Production database for user data
- MONGODB_URI_DEV
- Development database for user data
- MONGODB_URI_RULESET
- Database for ruleset data (read-only)
- PORT
- Main port for the web application, defaults to 8080
- PORT_API
- Separate port for the API, defaults to 3005
- NODE_ENV
- Set to 'production' if you are building for deployment
- Set to 'development' if you are developing
- LEGACY_WATCH=1
- Try adding this flag if you cannot get nodemon to update on changes
- SILENCE_WEBPACK=1
- Add this flag if you want to silence webpack output
- Commit new features to SEPARATE BRANCHES. Never commit to master.
- Pull often and frequently.
- Ensure that your commits are frequent and descriptive.
- MongoDB - Database used.
- React - Frontend JavaScript library.
- Express -Server/routing API for web app.
- Node - Backend JS runtime.
- Webpack - JS bundler for performance and ease of deployment.
- Sass - Used for easier CSS styling.
- Bootstrap - Frontend framework for website elements and styling.
- Bagelbits' 5e SRD API - API of the 5e ruleset, minorly altered for this project.
- Bradley Windybank's MERN stack template - Starter project for the beginning of development.