Skip to main content

Set up a GeoGirafe client

If you're new to GeoGirafe, this guide is the perfect place to start.

tip

GeoGirafe and this tutorial are written in TypeScript. However, it doesn't mean your project must be in TypeScript. We use Vite to bundle our project. Please ensure you follow the "Getting Started" guide for Vite before proceeding.

Requirements

  • NodeJS version 20+
  • GIT

Install

The version 0.9 of GeoGirafe can be installed with just one command:

npm create @geogirafe/template@latest my-geogirafe-app v0.9

This will :

  • create a folder my-geogirafe-app containing a minimal project of GeoGirafe.
  • download all the dependencies and build the project

This will take 2-3 minutes, depending on your network speed.

Once this is done, you'll have to create an SSL-Certificate that can be used for local development.
This is important, because some functionalities will only work with a valid SSL Certificate. This is a limitation of the browsers, that do not allow for example services-workers do work correctly is they are used on a non-secured website.

You can either do it manually on your own, or use the scripts provided by GeoGirafe and that will help you to create this certificate, and tell the system and the browser to trust it:

On Windows:

cd my-geogirafe-app
npm run generate-dev-certs-win

On Linux:

cd my-geogirafe-app
npm run generate-dev-certs

Then you can start the project :

npm start

That's it, you should now be able to see your first map, congratulations!

You can now start by reading the README file of the project, it contains the first explanations. Each file in this project also contains comments. This will allow you to better understand how is working GeoGirafe, and how you can configure it to your needs, add your own layers, ...

If necessary, you can always get in touch with us on Dicord: https://discord.com/channels/1194934479282778122

Have a nice journey with GeoGirafe! :-)