How a Portfolio Composes Itself

Start with the material you have

A project with one strong image should not need the same page layout as a project full of development notes. F34 builds its showcase from the material available. Providers offer blocks for images, videos, articles, files, activity, and connected services, together with priorities and preferred sizes. The page can then compose those blocks without knowing how each provider works.

Compose for the surface at hand

The layout engine turns those candidates into a composition for the current surface. It gives special consideration to featured artifacts, then seeks a useful balance of visual material, activity, and integration context. Candidates are deduplicated and expanded toward their preferred grid spans, allowing one image to occupy a dominant region while denser informational blocks remain compact. The same vocabulary can serve a portfolio panel, a project list, or a more expansive project dossier.

From candidates to composition

Visibility rules constrain what can be shown; the layout engine balances the eligible blocks.

flowchart TD
    Content[Visible project content] --> Providers[Showcase providers]
    Providers --> Candidates[Prioritized candidates]
    Candidates --> Layout[Deduplicate and balance]
    Layout --> Panel[Project panel]

Degrade without becoming empty

Resilience is part of the design. A failing provider is isolated so the rest of the showcase can still render, and a deliberate overview becomes the fallback when no richer content is available. Connected services do not make live requests during page rendering; they contribute bounded cached summaries and activity instead. That keeps a public portfolio fast and understandable even when an upstream service is unavailable.

Editorial control and automatic composition are intentionally separate. The owner decides which projects are public, which work is featured, and what claims to make about role or impact. The provider system supplies evidence from content that already passes the page's visibility rules. This lets the portfolio feel alive without allowing an integration to write its marketing story—or expose a private one.