BiL Explorer

Welcome to the BiL (Biodiversity-in-Literature) explorer!

This bachelor thesis project was produced during my time at the university of Leipzig, with help and guidance from Prof. Dr. Manuel Burghardt, Andreas Niekler, (Dr. Ing.), and Lars Langer.

It builds upon the data produced by this paper .

Prod Setup

Prerequisite: Install docker. Ask for .env file.

0. Change occurrence SERVER_URL fallback in the index.tsx file to match the server origin (not localhost:3000), as this will be run in the browser.
1. Run docker compose build && docker compose up.
2. Find and copy the bil-explorer_server container ID with docker ps.
3. Use docker exec -it [replace with containerID] bash to shell into the server container.
4. Reset and seed the database here with yarn prisma migrate reset --force (or manage the database using the prisma CLI - see yarn prisma -h).

Local Dev Setup

You will need to run a postgresql locally, see relevant docs in order to run.

Create a folder in the project root called data, which contains the data which must have been provided to you by the BiL paper team. You should have two files, one for the Author/Work metadata, and one for the occurrences.

Install node and yarn. (I will be using yarn but you can use npm aliases.)

Begin by filling the database, using yarn run refill, give your migration any name and afterwards the seeding process will begin. This will take some time, grab a drink.

After the database is filled, (once your occurrences are being filled you can already begin this step preliminarily) you can setup your dev environment locally by running yarn run dev:client, and yarn run dev:server, simaltaneously.

See the paper for the creation of this app here.

Feel free to contact me here .
For a complete, unique list of taxons that are available to this app, click here.
~ Ned O'Hara