README.md

CaptainFact.io

---

---

Getting started

If you're already have the API running locally, a simple npm install && npm start should be enough. Otherwise follow the procedure below:

• Install (if you don't have them):

  • The API project: https://github.com/opencollective/opencollective-api
  • NodeJS, ideally using asdf-vm with NODEJS_CHECK_SIGNATURES=no asdf install
  • App dependencies: npm install

• Run:

  • npm start - Start the front-end
  • npm run test - Runs all unit tests

Front-end is started on http://localhost:3333

A default account should have been created for you with e-mail=[email protected] and password=password.

Conventions

File structure

app
├── API => API libraries for both REST API and websockets
├── assets => Assets imported from JS
├── components => All react components
├── i18n => Translations
├── lib => Misc utilities
├── state => All redux related
│   ├── comments
│   │   ├── effects.js => Async actions creators, always return a promise
│   │   ├── record.js => The object representing a single comment
│   │   ├── reducer.js => Reducer + actions creators, always return an action object
│   │   └── selectors.js => Re-select selectors to select data in state
│   └── ...
├── static => Static assets, directly copied to the public directory
└── router.jsx => Application router and main entry point

Styling

Styling is based on Tailwind. Some legacy code still uses styled-components, but its usage is discouraged.

Main Libraries / Frameworks

• ES6 with Babel
• React: View layer
• React Router: Routing
• Phoenix: Interaction with https://hexdocs.pm/phoenix/Phoenix.Socket.html
• TailwindCSS: Utility-first CSS framework
• Redux: State management (deprecated)

Linked projects

• Community discussions and documentation
• API
• Extension
• Overlay injector

License

GNU AFFERO GENERAL PUBLIC LICENSE Version 3

Permissions of this strongest copyleft license are conditioned on making available complete source code of licensed works and modifications, which include larger works using a licensed work, under the same license. Copyright and license notices must be preserved. Contributors provide an express grant of patent rights. When a modified version is used to provide a service over a network, the complete source code of the modified version must be made available.

See LICENSE for more info.