Skip to content

Latest commit

 

History

History
68 lines (48 loc) · 2.63 KB

README.md

File metadata and controls

68 lines (48 loc) · 2.63 KB

Documentation Overview

This is the developer documentation for the Open Fixture Library. Please follow links in the folder structure below to get more information on a specific topic.

Repository folder structure

  • cli/ – Useful scripts to be called from the command line
  • docs/ – Documentation (you are here!)
  • fixtures/ – Repository of our fixture definitions
  • lib/ – Reusable modules used in the project
  • plugins/Plugins for export / import to / from other software's fixture formats
  • resources/ – Resources (e.g. gobos) that fixtures can use
  • schemas/ – Schemas for the fixture definitions
  • server/ – Load balancer config and auto-deploy script for everyone interested
  • tests/Unit tests, many of them run automatically in GitHub Actions
    • github/ – Special kind of tests which shouldn't be called manually and create comments in GitHub pull requests
  • ui/ – Everything related to the UI / Website (see docs there for subfolders)
  • tmp/ – Temporary files autogenerated by tests. Safe to delete and not indexed by Git.

Local installation

Linux / macOS

Make sure you have these dependencies installed:

Then run

git clone https://github.com/OpenLightingProject/open-fixture-library.git
cd open-fixture-library
npm install
npm run build

Continue with UI docs.

Windows

Make sure you have these dependencies installed:

Choose a project path that only contains ASCII characters and no spaces. Open a Terminal and run

git clone https://github.com/OpenLightingProject/open-fixture-library.git
cd open-fixture-library
npm install
npm run build

Continue with UI docs.

Contributing

Please see CONTRIBUTING.md.

Environment variables

See environment-variables.md.