kevinveenbirkenbach/homepage.veen.world

mirror of https://github.com/kevinveenbirkenbach/homepage.veen.world.git synced 2026-05-19 19:44:14 +00:00

Files

Kevin Veen-Birkenbach 3f30621630 feat(assets): probe-first resolver + SPOT for IMAGE_NAME/PORT + README screenshot

Probe-first asset resolution (regression fix)
---------------------------------------------

cache_manager.cache_file() returned either a relative cache path
(success) or None (failure). The previous app.py fallback
asset['cache'] = cached or asset['source'] mixed both types into
one field, which the template wrapped in url_for('static', ...)
regardless — producing broken
/static/https://file.infinito.nexus/.../logo.png URLs whenever the
source couldn't be downloaded.

- New app/utils/asset_resolver.py: HEAD-probes the URL (3 s
  timeout, image/* content type). On hit, embed directly via a
  new external_url field — no download required. On miss, fall
  back to cache_manager.cache_file. If that also fails, expose
  the source URL via external_url so the browser shows the alt
  text instead of an empty src.
- app.py exposes an asset_src(asset) context processor that
  picks external_url first, then url_for('static', cache),
  so the template never wraps an absolute URL in a static prefix.
- Templates (base, navigation, card) switch to asset_src(...) and
  gate the card image branch on cache or external_url.
- 16 unit tests cover every probe/cache/fallback branch; one live
  integration test exercises the canonical
  https://file.infinito.nexus/assets/img/logo.png to prove the
  probe-first path works end-to-end (cache dir stays empty).
- config.sample.yaml: new Infinito.Nexus card driven by the same
  canonical asset URL.

Single source of truth for IMAGE_NAME and PORT
----------------------------------------------

- env.example is now the only place the literal values live.
- Makefile and docker-compose.yml reference \$(IMAGE_NAME) /
  \${IMAGE_NAME:?…} (same for PORT); no defaults, no silent
  fallbacks.
- New make env / make config bootstrap .env / app/config.yaml
  from their checked-in templates. Idempotent.
- All container-using targets depend on the two bootstrap targets
  so a fresh checkout runs in a single invocation.
- Recipes source .env at recipe-execution time so they pick up a
  freshly bootstrapped .env in the same make invocation.

README
------

- Screenshot added under the title.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-18 12:19:15 +02:00

4.3 KiB

Raw Blame History

PortUI 🖥️✨

A lightweight, Docker-powered portfolio/landing-page generator—fully customizable via YAML! Showcase your projects, skills, and online presence in minutes.

🚀 You can also pair PortUI with JavaScript for sleek, web-based desktop-style interfaces.
💻 Example in action: CyMaIS.Cloud (demo)
🌐 Another live example: veen.world (Kevin’s personal site)

✨ Key Features

Dynamic Navigation
Create dropdowns & nested menus with ease.
Customizable Cards
Highlight skills, projects, or services—with icons, titles, and links.
Smart Cache Management
Auto-cache assets for lightning-fast loading.
Responsive Design
Built on Bootstrap; looks great on desktop, tablet & mobile.
YAML-Driven
All content & structure defined in a simple config.yaml.
CLI Control
Manage Docker containers via the portfolio command.

🌐 Quick Access

Local Preview:
http://127.0.0.1:5000

🏁 Getting Started

🔧 Prerequisites

Docker & Docker Compose
Basic Python & YAML knowledge

🛠️ Installation via Git

Clone & enter repo

git clone <repository_url>
cd <repository_directory>

Configure Copy config.sample.yaml → config.yaml & customize.
Build & run
```
docker-compose up --build
```
Browse Open http://localhost:5000

📦 Installation via Kevin’s Package Manager

pkgmgr install portui

Once installed, the portui CLI is available system-wide.

🖥️ CLI Commands

portui --help

build Build the Docker image
up Start containers (with build)
down Stop & remove containers
run-dev Dev mode (hot-reload)
run-prod Production mode
logs View container logs
dev Docker-Compose dev environment
prod Docker-Compose prod environment
cleanup Prune stopped containers

🔧 YAML Configuration Guide

Define your site’s structure in config.yaml:

accounts:
  name: Online Accounts
  description: Discover my online presence.
  icon:
    class: fa-solid fa-users
  children:
    - name: Channels
      description: Platforms where I share content.
      icon:
        class: fas fa-newspaper
      children:
        - name: Mastodon
          description: Follow me on Mastodon.
          icon:
            class: fa-brands fa-mastodon
          url: https://microblog.veen.world/@kevinveenbirkenbach
          identifier: "@kevinveenbirkenbach@microblog.veen.world"
  cards:
    - icon:
        source: https://cloud.veen.world/s/logo_agile_coach_512x512/download
      title: Agile Coach
      text: I lead agile transformations and improve team dynamics through Scrum and Agile Coaching.
      url: https://www.agile-coach.world
      link_text: www.agile-coach.world

company:
  title: Kevin Veen-Birkenbach
  subtitle: Consulting & Coaching Solutions
  logo:
    source: https://cloud.veen.world/s/logo_face_512x512/download
  favicon:
    source: https://cloud.veen.world/s/veen_world_favicon/download
  address:
    street: Afrikanische Straße 43
    postal_code: DE-13351
    city: Berlin
    country: Germany
  imprint_url: https://s.veen.world/imprint

children enables multi-level menus.
link references other YAML paths to avoid duplication.

🚢 Production Deployment

Use a reverse proxy (NGINX/Apache).
Secure with SSL/TLS.
Swap to a production database if needed.

📜 License

Licensed under GNU AGPLv3. See LICENSE for details.

✍️ Author

Created by Kevin Veen-Birkenbach

Enjoy building your portfolio! 🌟

4.3 KiB Raw Blame History Unescape Escape