Skip to content

farirpgs/fari-app

Repository files navigation

TODO

Fari - The Free and Open-Source Virtual Tabletop

All Contributors

patreon ko-fi

Continous Integration Integration Tests

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

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

  1. 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

💻

This project follows the all-contributors specification. Contributions of any kind welcome!