⚙️ Settings
Customize every aspect of your Panoramax frontend—environment variables, wording, and visuals—all from one place.
🔐 1. Environment Variables
Most low-level settings live in the .env file (see env.example). Below is a quick reference grouped by domain.
🌐 General
| Variable | Description | Example | Notes |
|---|---|---|---|
VITE_API_URL |
Base URL of the Panoramax API | https://panoramax.ign.fr/ |
Required |
🗺️ Map
| Variable | Description | Example |
|---|---|---|
VITE_TILES |
URL to a MapLibre JSON style (vector tiles) | https://data.geopf.fr/.../PLAN.IGN/standard.json |
VITE_MAP_ATTRIBUTION |
Attribution string displayed on the map | © IGN |
VITE_RASTER_TILE |
Raster (aerial imagery) source (MapLibre raster spec) | https://example.com/raster.json (optional) |
VITE_ZOOM |
Default zoom (0–24) | 6 |
VITE_CENTER |
Default map center longitude,latitude |
2.213,46.227 |
📝 SEO & Viewer
| Variable | Description | Example |
|---|---|---|
VITE_TITLE |
<title> value |
Panoramax IGN: photo-cartographier les territoires |
VITE_META_TITLE |
Meta title (og:title, etc.) |
Panoramax IGN |
VITE_META_DESCRIPTION |
Meta description for SEO | L'instance Panoramax IGN permet ... |
💡 Need a reminder of how these vars are used? Check the
src/configfiles in bothapp/andadmin/.
✍️ 2. Wording & Languages
You can fully tailor wording for both the end-user app and the admin interface.
📁 Locale Files
- App:
app/src/locales - Admin:
admin/src/locales
Key entries worth editing:
title,meta.title,meta.description- Help links (
upload.description,upload.footer_description_terminal, etc.)
🌍 Translating / Adding Languages
- Edit JSON files directly (French & English provided).
- Or use the collaborative platform Weblate.
- Adding a new locale?
- Drop
{locale}.jsonin the locale folder. - Register it in
src/config/locales.ts.
🖼️ 3. Visual Assets
Customize the look & feel by replacing the default assets:
| Asset | File | Tip |
|---|---|---|
| Logo | src/assets/images/logo.jpeg |
Use a square image for best results |
| Favicon | static/favicon.ico |
Provide multiple sizes if possible |
