codex-frontend

The frontend for Codex, written in React with Material UI components. This project is not in production yet, but it is under active development.

Contributions

Found a bug? Submit a report here.

Developer contributions are very much appreciated. Refer to the contribution guide. If you are a Python dev looking to help with our project, take a look at the backend. If you are a data scientist looking to help, take a look at WBIA.

We are also looking for help from designers and 3D modelers! Please send an email to [email protected] if you are interested.

Development

Just run

npm install
npm start

The development environment is mostly used on OSX but should work on Windows as well. Use Powershell or edit the npm start:win32 command to set NODE_ENV using the appropriate syntax for your preferred shell.

If you are doing development, you should set up husky so that the linter runs before you commit. All you need to do is run the command npm run prepare.

Unfortunately, the frontend isn't very useful without a backend. To run the frontend in its proper context, you need to install Docker, clone Houston, and edit docker-compose.codex.yml. Modify the dev-frontend image to point to your local copy of the code in the following manner:

dev-frontend:
  ...
  volumes:
    - ./dev-frontend/docker-entrypoint.sh:/docker-entrypoint.sh
    - ../../_frontend:/code     <---- delete this line!
    - /location/of/frontend/repository:/code <----- add this line!

After that you should be able to run the following commands:

./scripts/codex/activate.sh
./scripts/codex/build.frontend.sh
docker-compose pull
docker-compose build
docker-compose up -d

Note: docker-compose pull takes a very long time to finish the first time around! But when it's all done you should be able to see the frontend on localhost:80. If you see a 502 nginx error instead, you may need to increase the amount of memory available to Docker. 6GB memory and 2GB swap works for my system.

The following commands are helpful when developing in this manner:

• docker-compose up -d: Run all containers in daemon mode, so you don't see all the logs running together.
• docker-compose restart <image>: Restart a particular docker image (remember these are listed in docker-compose.yml).
• docker-compose logs -f <image>: Show logs for a particular image.
• docker-compose down: Stop all images.

Configuration and build

A build can be initiated with the command npm run build. You can specify the URL for Houston in /config/config.json or as a command line argument. Here are some examples:

npm run build -- --env=houston=https://houston.dyn.wildme.io
npm run build -- --env=houston=http://localhost:9999
npm run build -- --env=houston=relative // use relative file paths for API requests

Thanks

• Thanks to Lokalise for providing translation management services.
• Thanks to Flatfile for providing data import services.
• Thanks to Emily Ke for developing the server status screen, page transitions, and more!
• Thanks to Madeleine Webb for design assistance.
• Thanks to Iris Shin for design assistance.