Skip to content

terrestris/react-geo-client-template

Folders and files

NameName
Last commit message
Last commit date
Sep 3, 2024
Mar 25, 2022
Sep 16, 2024
Dec 11, 2024
Apr 19, 2022
Mar 25, 2022
Apr 19, 2022
Apr 14, 2022
Aug 23, 2023
Aug 23, 2023
May 2, 2022
Sep 6, 2024
Oct 19, 2022
Mar 25, 2022
Dec 11, 2024
Dec 11, 2024
Dec 11, 2024
Jan 22, 2025
Jan 22, 2025
May 2, 2022
Sep 16, 2024
Sep 16, 2024
Sep 16, 2024
Sep 3, 2024

Repository files navigation

react-geo client template

This template application demonstrates the usage of react-geo and can easily be installed via the create-react-geo-app (CRGA) command line tool.

Features ⭐

This application contains several features to increase the development experience, e.g.:

Getting started πŸ§‘β€πŸ’»

Install all required dependencies via:

npm i

And start the local development server:

npm run start

The application is now available at https://localhost:8080.

Recommendation: If you already have an existing docker-compose setup e.g. providing a backend, the client should communicate with, we recommend to start the client inside this setup as this would make redundant the need for several custom configuration (e.g. a webpack proxy). To include the client, just extend your existing docker-compose.yml with a service similiar to the following example:

react-geo-client-template:
  build:
    context: ../react-geo-client-template
    dockerfile: Dockerfile.dev
  ports:
    - 8080:8080
  volumes:
    - ../react-geo-client-template:/app

Please note that your local node version should always match the node version inside the Dockerfile.dev.

e2e tests πŸ§ͺ

To run the e2e tests locally it's probably required that you install all required browsers and system dependencies via:

npx playwright install
npx playwright install-deps

Road to production 🏭

The build artifact of the client can either be build via

npm run build

or directly included in an nginx based Docker image via:

docker build -t react-geo-client:1.0.0 .

(Run docker run -p 80:80 react-geo-client:1.0.0 to start it locally.)

Contribution

Contributions are much appreciated! πŸ₯³

Read the hints for developers to get started. We look forward to your contributions!