Yito

Tree management application built with Laravel and Inertia.js + Vue 3.

Requirements

System Requirements

• PHP 8.5+ with the following extensions:
  • pdo_pgsql
  • pgsql
  • ffi (dev/test only — for H3 factory in tests)
• PostgreSQL 15+ with PostGIS 3.3+ extension
• Node.js 20+
• Composer 2.6+
• pnpm or npm

PHP FFI Configuration (dev/test only)

FFI is only needed for running tests and seeding data (the TreeFactory uses h3-php to generate H3 indices). Production web requests compute H3 on the frontend via h3-js.

Add to your php.ini for CLI/test usage:

ffi.enable=true

For Laravel Herd, add to ~/Library/Application Support/Herd/config/php/85/php.ini:

ffi.enable=true

Then restart the PHP service.

PostgreSQL + PostGIS

Create the database and enable PostGIS:

CREATE DATABASE yito;
\c yito
CREATE EXTENSION IF NOT EXISTS postgis;

Installation

composer install
npm install
cp .env.example .env
php artisan key:generate
php artisan migrate
npm run build

Development

composer run dev

Or run services separately:

php artisan serve
npm run dev

Testing

php artisan test

Tech Stack

• Backend: Laravel 13, PHP 8.4
• Frontend: Inertia.js v3, Vue 3, TypeScript, Tailwind CSS v4
• Database: PostgreSQL with PostGIS
• Spatial: H3 hexagonal indexing, Clickbar Magellan (PostGIS ORM)
• Maps: Leaflet (vue-leaflet)