tlca-frontend

Frontend of the TLCA platform

Quick install

Start by installing required dependencies:

• Node.js (10+)
• Yarn Classic

Then, clone the Git repository, and launch the installation:

> git clone https://github.com/TLCA-project/tlca-frontend.git
> cd tlca-frontend
> yarn install

Once successfully installed, you can run a local dev server:

> yarn dev

And the resulting website should be available locally on http://localhost:3000.

Install in Docker Development Environment

You can also use a Docker Development Environment instead of installing the application on your own machine.

First, install or upgrade Docker on your host, to have the latest Dev Env features.

With VSCode support for remote containers, you can edit source files that are inside the container directly from the IDE on your local machine.

The base image for the environment development is node:16. This can be modified in the .docker/config.json file.

There are two possible ways to work:

• the source files can remain on your local filesystem, with all the dependencies files, and you use a container to run the application, knowing that any change in the container is reflected back on your local machine,
• or you can keep the source files entirely in the container, with all the dependencies files, edit the code with VSCode on your local machine, check the results on your local browser, knowing that the code does not need to exist on your host filesystem.

Using a local folder

Start a Docker Development Environment from Docker Desktop. For that, first “Create” a “New Dev Environment” and choose the “Local Directory” source. Select the tlca-frontend directory on your local filesystem, and finish the interactive wizard. You can now push the “Open in VSCode” button.

Once in VSCode, you can edit the source files, but also run the development server. Open a terminal in the container from VSCode, and run:

> yarn install
> yarn dev

Once the server is started, you'll be able to access the frontend via http://localhost:3000.

Using a remote repository

Use the same procedure as above, but choose source “Existing Git Repo” and provide the URL of the repository (you can specify a specific branch by adding its name prefixed with a @ character at the end of the git URL). As above, run:

> yarn install
> yarn dev

and open http://localhost:3000 in your browser to view the resulting website.