Fari - The Free and Open-Source Virtual Tabletop

This repo contains the source code that powers Fari, the open source virtual tabletop platform.

Feature Requests

You can request new features here

Bug Report

If you found an issue with the app, you can report the bug here

Development

If you want to make a contribution to Fari, you will need to fork / clone this repo and follow the following steps to run the app locally.

Prerequisites

Install Node ^16.2.0 (to match engine property in package.json) or use the devcontainer provided using VS Code.

Installation

Fari relies on Node and the Node Package Manager to download its dependencies and run.

If you are using the proper node and npm version, you then need to install Fari's dependencies

npm install

Once the dependencies are installed, Fari will also build some of it's static content (e.g. the content of the SRD) using 11ty which will convert the markdown files to HTML files insides a _site directory.

Running the application

If you want to run Fari on your machine, simply run:

npm run start

This will start and bundle the app using ViteJS and make it available on http://localhost:1234

ViteJS will also update your browser's content (using React Refresh) anytime you do save a file on the disk.

This will run the normal server, but also rebuild the markdown files everytime you modify them.

Special Thanks

Netlify for hosting Fari.
Lokalise for providing internalization feature for Fari.
Canny for providing user feedback features for Fari.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_rpdeshaies 💻 📖 🌍 👀	_{Davide Vernassa} 🌍	_corrina 🌍	_Erynus 🌍	_hattivatt 🌍	_{pedrogsribeiro} 🌍	_nfregoso 💻
_ConDar15 💻	_{Jorge Diz Pico} 🌍	_{Thomas Bearse} 💻	_1d12monos 🌍	_chocoporto 🌍	_Gpoitras 💻	_{Christie Kennedy} 💻