odkrywajac_polske

Crystal static site generator for a Polish travel/photography blog. Custom-built on tremolite framework.

Live site: odkrywajacpolske.pl

Quick Start

# Render site (dev environment, local target)
make dev-render-local

# Serve locally
make dev-serve-local  # http://localhost:5001

# Run Crystal tests
crystal spec

# Run E2E tests (requires: cd tests/e2e && npm i && npx playwright install chromium)
make test-e2e

Prerequisites

Project Structure

env/
├── dev/                    # Dev environment (subset of posts)
│   ├── src/               # Entry points (render_local.cr, render_release.cr)
│   ├── public/local/      # Output for local dev
│   └── public/release/    # Output for production
└── full/                   # Full environment (all posts)

data/
├── src/                    # Core application code
│   ├── blog.cr            # Main orchestrator
│   ├── view_registry/     # View registration system
│   ├── views/             # All view classes
│   ├── models/            # Entity models (Post, AreaEntity, Tag, etc.)
│   └── services/          # Business logic (asset loading, validation, etc.)
├── assets/                 # Static assets (CSS, JS, images)
├── layout/                 # HTML templates
├── posts/                  # Markdown blog posts
├── routes/                 # GPX route files
└── config/                 # YAML configurations

commands/                   # Standalone scripts
tests/e2e/                  # Playwright E2E tests
spec/                       # Crystal unit tests

Commands

Features (Compact)

Content System

• Posts: Markdown with YAML frontmatter, multi-route support, photo galleries
• Areas: Unified entity system (towns, counties, voivodeships, meso/macro regions) with polygon matching
• Tags: Hierarchical with Polish slugs, auto-generated galleries
• Routes: GPX parsing, distance calculation, area intersection detection

Rendering

• View Registry: Priority-based rendering (tasks 1-9, views 10+), dependency tracking
• Asset Bundles: Declarative CSS/JS bundles with integrity hashes, cache busting
• Templates: ECR + HTML templates with placeholder substitution
• Output: HTML, RSS, Atom, JSON payload, sitemap, photos.json

Frontend

• Maps: Leaflet for routes, Preact interactive components
• Galleries: Lazy-loaded images, ambilight lightbox, EXIF display
• Interactive: Timeline, photo planner, area statistics, POIs map

Infrastructure

• Environments: dev (fast iteration) / full (complete render)
• Caching: Area calculations, nav stats, EXIF data
• Validation: HTML validators (accessibility, links, duplicates), asset verification
• History: Output change tracking per env/target

Data Pipeline

• Area Matching: Route → polygon intersection via AreaMatcher service
• Polygon Generation: Douglas-Peucker simplification, GeoJSON output
• EXIF Processing: Photo metadata extraction, statistics generation

Tech Stack

Key Files

Tests

Crystal: 589 unit tests covering views, services, models, commands

crystal spec
crystal spec spec/views/  # Views only

E2E: ~137 Playwright tests across 15 spec files (smoke, posts, maps, galleries, areas, POIs, social meta)

cd tests/e2e && npm install && npx playwright install chromium
make test-e2e

License

GPLv3

Author

Aleksander Kwiatkowski