Geospatial web application built with Laravel 12, Vue 3, Vuetify, and MapLibre GL.

• Geospatial Ready: Built-in support for vector tiles (PMTiles), spatial database functions, and interactive maps.
• Modern & Fast: Uses Vite, HTTP/3 ready stack, and efficient vector tiles.
• Fully Containerized: Docker for easy setup and consistency.
• Scalable: Separation of concerns with dedicated map tile server (Martin) and Laravel backend.

geoglify/
├── database/           # Database Docker configuration & init scripts
├── martin/            # Martin Tile Server configuration
├── pmtiles/           # Data directory for hosted .pmtiles (Ignored by Git)
├── webapp/            # Main Laravel + Vue.js Application
│   ├── app/
│   │   ├── Http/     # Controllers, middleware, requests
│   │   └── Models/   # Eloquent models (Feature, Layer, Attribute, etc.)
│   ├── resources/
│   │   ├── js/       # Vue components, pages, services
│   │   │   ├── Components/  # Reusable Vue components
│   │   │   ├── Pages/       # Inertia pages
│   │   │   └── translations/ # JSON translations (generated)
│   │   └── lang/     # PHP translation files (source for i18n)
│   ├── database/
│   │   ├── factories/  # Model factories
│   │   ├── migrations/ # Database migrations
│   │   └── seeders/    # Database seeders
│   └── routes/       # API and web routes
└── docker-compose.yml  # Container orchestration

• Docker
• Docker Compose

Clone the repository:

git clone <repository-url>
cd geoglify

Start the application stack:

docker compose up -d

Services:

Useful URLs:

• Application: http://localhost:8080/
• Map Tiles: http://localhost:8081/map/{z}/{x}/{y}
• Map Style Editor: http://localhost:8888/
• Email Tester: http://localhost:8025/

The project includes a geoglify-tiles-downloader service to automatically fetch OSM data and convert it to PMTiles format.

docker compose restart geoglify-tiles-downloader

The resulting .pmtiles files are stored in the ./pmtiles directory and served by Martin.

Configuration is handled via standard Laravel .env files.

Configured in martin/config.yaml.

• By default, it looks for .pmtiles in /pmtiles directory.
• CORS is enabled for all origins (*).

# Start all services
docker compose up -d

# View logs
docker compose logs -f webapp

# Stop all services
docker compose down

# Run artisan commands
docker compose exec webapp php artisan <command>

# Install dependencies
docker compose exec webapp composer install

# Generate translations
docker compose exec webapp php lang/generate-translations.php

# Format code
docker compose exec webapp vendor/bin/pint --dirty

# Install dependencies
docker compose exec webapp npm install

# Development server
docker compose exec webapp npm run dev

# Build for production
docker compose exec webapp npm run build

Geoglify uses a PHP-to-JSON translation system:

1. Source: PHP files in webapp/resources/lang/{locale}/
2. Generator: webapp/lang/generate-translations.php
3. Output: JSON files in webapp/resources/js/translations/

Adding new translations:

# 1. Add to PHP files (e.g., resources/lang/en/global.php)
# 2. Add to Portuguese version (resources/lang/pt/global.php)
# 3. Regenerate JSON files
docker compose exec webapp php lang/generate-translations.php

Always edit PHP files, not JSON files directly.

1. Fork repository.
2. Create your feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes.
4. Push to the branch.
5. Open a Pull Request.

Made with love for technology and open source.