Skip to content

.impeccable.md

Latest commit

 

History

History
49 lines (40 loc) · 6.3 KB

.impeccable.md

File metadata and controls

49 lines (40 loc) · 6.3 KB

Design Context

Users

PolyPet serves two audiences: library consumers (indie game developers, hobbyists, and learners integrating procedural pets into Unity/Godot projects) and end-users (players and casual users who interact with the generated creatures in finished apps). The library itself has no UI -- design context applies to the visual identity of generated polygon pets and any future sample scenes or documentation.

Brand Personality

Cute, playful, quirky, bold, colorful, fun, simple. The voice is toy-like and cheerful with a geometry pun at its core ("Acute-ly"). Pets should feel immediately charming and slightly weird in an endearing way -- never generic, corporate, or dark.

Reference Pillars

Each reference contributes a specific dimension to PolyPet's identity:

Tamagotchi -- Retro & Simplicity

Draw from Tamagotchi for the feeling of interacting with a PolyPet:

  • Economy of form, not resolution: Tamagotchi's charm came from using very few visual elements to convey personality -- not from low fidelity itself. PolyPet applies the same philosophy to resolution-independent 2D vector geometry: few shapes, clean edges, readable at any size.
  • Kawaii proportions: Oversized heads (2:1 or 3:1 head-to-body ratio), dot eyes placed high on the face, blobby rounded bodies, stub limbs or none at all.
  • Idle = alive: Constant gentle bouncing was the primary signal of life. PolyPet's idle bob serves the same role.
  • Toy-like simplicity: The physical egg shell made Tamagotchi feel like a toy, not software. PolyPet should inherit this "toy you carry around" energy -- minimal interface, maximum charm.
  • Silhouette differentiation: Tamagotchi creatures were distinguished by outline alone -- pointy vs. round, tall vs. squat, with/without ears, antennae, or tails. PolyPet's seed variety should focus here.

Peridot -- Procedural Pets, Body Parts & Colors

Draw from Peridot for what a PolyPet is made of and how it varies:

  • Chromosome-based generation: Peridot uses 8 chromosomes (pattern, color, face, ears, horns, material, plumage, tail) with continuous numerical parameters per chromosome. The ear chromosome alone has 24 parameters -- yielding 2.3x10^24 combinations.
  • Shared base body, varied appendages: All Peridots share the same base body proportions (varying body shape broke animations). Variety comes from ears (rabbit, bat, floppy), horns (goat, unicorn, antlers), tails (bushy, thin, plume), plumage (crests, manes), and face (eye shape, markings).
  • Color archetypes: Peridot organizes color into named archetypes -- Unicorn (pastels/iridescence), Peacock (jewel tones), Jester (bold contrasts), Clownfish (warm orange/white). Colors range from soft naturals to rich saturated tones but stay warm and appealing. PolyPet should use Peridot-style color ranges: bright, warm, harmonious palettes -- not neon.
  • Pattern generation: Surface patterns inspired by biological reaction-diffusion (giraffe spots, tropical fish stripes, circuit traces). PolyPet's polkadots/stripes/spots serve a similar role at lower fidelity.
  • Oversized expressive eyes: "Huge anime eyes" -- the largest facial feature, firmly in the Disney-Pixar school of emotive design.

Geometry Wars -- Shapes, Geometry & Charm

Draw from Geometry Wars for how PolyPet renders and presents geometry:

  • Shape = identity: Every Geometry Wars entity is a distinct geometric primitive. Shape+color pairs are instantly readable. No textures, no sprites -- pure vector geometry. PolyPet's polygon vocabulary (triangle through octagon, circle) follows this philosophy.
  • Behavioral animation over detail: Shapes rotate, pulse, and breathe. Green squares tumble, pinwheels spin. Simple geometry feels alive through motion signatures, not anatomical detail.
  • Flat fills with clean edges: Shapes are solid-filled with hard edges. Visual richness comes from color contrast and motion, not gradients or shading.
  • NOT neon: PolyPet borrows the geometric clarity and shape-as-character philosophy, but uses Peridot-style warm/bright colors instead of Geometry Wars' electric neon-on-black palette.
  • Satisfying feedback: Geometry Wars makes every interaction feel impactful through disproportionately large particle bursts and audio sync. PolyPet's squish reaction should aim for similar "more response than expected" delight.

Aesthetic Direction

  • Visual tone: Flat geometric shapes with retro toy simplicity. Clean polygon silhouettes with solid bright fills. Hard edges, no gradients on shapes.
  • Color direction: Peridot-style -- bright, warm, harmonious. Saturated but not neon. The HSV range (sat 0.4-0.8, value 0.7-1.0) stays vivid and avoids muddy, dark, brown, gray, or desaturated tones. Palette archetypes should produce warm jewel tones, pastels, and bold primaries -- never electric/fluorescent.
  • Anti-references: No realistic/detailed rendering (no fur, shading, or naturalistic anatomy). No corporate mascot or stock art feel. No dark, edgy, or horror aesthetics. No neon-on-black Geometry Wars color treatment.
  • Theme: No UI theme applies -- this is a rendering library. Design guidance targets the polygon pets themselves and their visual language.

Design Principles

  1. Silhouette first -- A pet should be recognizable from its outline alone, like a Tamagotchi creature. Vary shape, proportion, and appendage type before adding surface detail. Geometry is 2D vector-based and resolution-independent -- simple shapes rendered crisply at any size.
  2. Geometry is the brand -- Polygons are not a limitation, they're the identity. Lean into clean edges, flat fills, and visible facets like Geometry Wars -- don't smooth them away.
  3. Warm and bright -- Colors follow Peridot, not Geometry Wars. Saturated jewel tones, warm pastels, bold primaries. If a palette looks neon, muddy, or hostile, it's wrong.
  4. Simple but alive -- Tamagotchi proved that idle motion is the primary signal of life. Constant gentle bobbing, reactive squish, and oversized expressive eyes make minimal geometry feel like a creature.
  5. Variety without chaos -- Peridot achieves 10^24 combinations from a shared base body with varied appendages. Seeds should produce obviously distinct pets that all belong to the same species family. Consistency in proportions and style, diversity in shape, color, and features.