Skip to content

TrailView: a modelling kit and style guide, first used for the animals #3786

Open

Description

@timohueser

Status: approved

Part of epic #3782 (part 3). Depends on #3785. The epic holds the facts about today's animals, the budget and the owner's decisions.

TL;DR

Goal: one way to make every TrailView model ourselves, in one style: a shared modelling kit in code, a style guide and a review page. The animals are the first models made with it.
Decision: all models are our own TypeScript files built with one kit; asset packs and photos are only inspiration and references. Style: low-fidelity, game-like, cute, never odd, few triangles. Each species file holds traced outlines (from public-domain or CC0 photos), colours, poses or seasons, and seeds; the build makes the tiers inside the budget of specs/trailview-models.md.
Systems: trailview
Contracts: none (it keeps specs/trailview-models.md)
Size: M (a look change across many model files, more than 500 changed lines)

Plan

  1. Mock-ups: a cow, a sheep and a goat in 2 or 3 style variants made with a first cut of the kit, at 10 m and 100 m in the engine, next to today's models. The owner chooses the style; nothing else is built before.
  2. The kit (grown from models/shape.ts and models/flat.ts), the style guide in docs/content/ with pictures, and the review page (turntable per tier, counts against the budget, today's model beside it).
  3. Remake the animals: about 12 species models (cattle, highland cow, sheep, goat, ibex, chamois, red deer, reindeer, horse, donkey, pig, dromedary) with 2 or 3 poses; tier 0 to 150 m at most 1,000 triangles, tier 1 to 1,500 m at most 250.
  4. The same kit then remakes every other generated model, one kind at a time: the trees (TrailView: remake the trees with the modelling kit #3797), the plants and shrubs (TrailView: remake the plants and shrubs with the modelling kit #3798), the rocks (TrailView: remake the rocks with the modelling kit #3799) and the small objects of the kinds (TrailView: remake the small objects of the kinds with the modelling kit #3800).

Done when

  • The owner approves the mock-up style, then the before/after gallery (near 10 to 30 m and far 300 to 1,000 m, summer and winter, cattle, sheep, goats and one new species).
  • One flight on the M1 Pro and one at the phone canvas of 780 x 1688, develop against the branch, alternated: not noticeably slower, within the noise.

Out of scope: where and when animals and plants stand (the herd and plant placement is temporary), and flowers that bloom by region and season.

Prototype: which modelling style should the kit use?

Answer: style a, soft low-poly (the owner's choice, 2026-11-22).
Evidence: a cow, a sheep and a goat in three styles (a: soft low-poly, b: chunky toy, c: natural faceted), shown in the engine on the Engelberg meadow next to today's models at 10 m and 100 m, with a showroom address switch that stands a row of breeds before the eye. Style a: cow 636, sheep 600, goat 608 triangles. All styles read at 100 m.
For the design: a's way of building: round skins lofted through rings of 10 to 12 sides with separate up and down reach and a pitch; a friendly, slightly large head with eyes, ears and a cream muzzle; short sturdy legs with stepped hooves; small details (udder, tail tuft, lumpy wool, beard, swept horns); faces turned away from a point inside each part, so no hand winding. Next for a: fewer, larger wool lumps (the lump reads as facet noise at 10 m), and ears that the horns do not hide.
Branch: https://github.com/timohueser/OpenBikeComputer/tree/prototype/animal-styles

Activity

  1. timohueser commented on Nov 22, 2026

    @timohueser
    OwnerAuthor

    Built in #3801: the kit (models/sculpt.ts), 14 breeds in 12 body shapes with 3 poses each, the review page (tests/browser/trailview/models.mjs) and the style guide (docs/content/software/trailview-models.md). The before/after gallery waits for the owner's approval: https://claude.ai/artifact/VyMRtxCuEcx6jfzjUbYdAb. Frame time on the M1 Pro, desktop and phone canvas: no change beyond the noise.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions