Skip to content

A winter to share (2026-11-09) ​

Why ​

  • Winter is the emptiest season in the yard: no bugs, few flowers, and December only adds fairy lights and one snowman gift.
  • The yard is for healing. Winter should feel cute, sparkling and warm, and give the person things to do with friends rather than more things to count.
  • The year's end is a moment people already pause on. A friend who asks how the year went, and remembers the answer, is what makes a pet feel like a friend.

Goals ​

  • December fills the yard step by step: a small Christmas tree, a baby reindeer and Santa come as gifts, the tree gets decorated a little each day, and on a snowy December night it becomes a grand tree.
  • Winter play: building a snowman with friends, and following animal footprints in the snow.
  • At the year's end a friend writes a letter, asks about the year and next year, and brings the person's answer back in the New Year and again the next December.

Non-goals ​

  • No photo or album snapshot of the yard.
  • No living creatures (fish, bugs) hung as ornaments.
  • No streaks, scores or "did you do it?" checks on the person's plans.
  • No Lunar New Year; it is a later design, as its date differs by country.
  • The desktop overlay stays as it is: friends, names, bubbles and gifts only.
  • No trademarked names: the reindeer is "baby reindeer", never a named character.

Anti-goals (a failure even if it works) ​

  • The yard feels busy or noisy in December.
  • The person feels guilty about a plan they did not follow.
  • The yard's words reach an AI unlabeled, or the person's answer leaves the computer when no AI is connected.
  • A canvas repaints every frame, or the frame loop gains steady work.

Seeing winter ​

RuleDetailWhy
The lights event runs 12-01 to 12-31 and is fixedWas 12-10, and moved six months in the southChristmas is in December everywhere; the gifts must be reachable all month, so missing one day must not mean missing them
Christmas comes by the calendarDuring lights the event gift comes whatever season the yard shows, in every world (studio too). The page passes the calendar event to receiveGift, not only the scene'sAnswering "keep my season" must not cost the person Christmas
Ask once in DecemberWhen the yard is not showing winter during lights, ask once a year: show the winter yard until 01-07, or keep it. If they say yes, the earlier season choice comes back on 01-08 (winterAsked: {year, previous})The yard's season defaults to spring, so most people would never see snow; the same question works north and south
Christmas decor by dateKinds with "shown": "december" (the tree, the reindeer, Santa) show from 12-01 to 01-07 whatever the season, and are hidden the rest of the year with their state keptA Christmas tree in summer is out of place; nothing is lost
Winter-only decorKinds with "seasons": ["winter"] (the built snowman) show only while the yard shows winterA snowman belongs to snow
LimitsHidden decor still counts toward DECOR_MAX; there are at most four such kindsKeeps the limit rules unchanged
No snow, no snow playChristmas night, building a snowman and footprints need the yard to show winter; studio has none of them. The letter and decorating work everywhereThey are about snow; the letter and the tree are not

Christmas gifts ​

WhatRule
New gift kindsxmas_tree (small Christmas tree), baby_reindeer, santa, appended at the end of gifts (the first 16 feed mementos) with "event": "lights" and "shown": "december"
How they comeDuring lights the event gift is the first of these not yet received, in that order, through the normal gift rules (every other day, after doing something with a friend). The snowman is no longer an event gift: it comes from building one (below)
Putting awayThese three go back into the gift box like a memento, never thrown away, so the tree can always be set out again
The years afterOnce all three are received, December brings no new event gift; the decorating, Christmas night and the letter are that year's Christmas
AlbumThey are gift entries like any other, so they show in the gift book

Christmas night ​

WhatRule
WhenDuring lights, the yard shows winter, it is evening or night, it is snowing, and xmas_tree is set out in the yard
The changeThe small tree becomes the grand tree in place, ground contact fixed: lights climb from the roots, a gold veil reveals the grand tree bottom to top while the small one fades, the star swells once, a warm light pools on the snow, nearby friends look up. About 2.6 s, once per night
AfterThe grand tree stays while the conditions hold; a single bulb glints now and then (10 to 16 s apart). When they stop holding it goes back to the small tree with a short crossfade
All three outWith the grand tree showing and baby_reindeer and santa both in the yard: the reindeer, then Santa, look up; a dark sleigh silhouette with a warm gold rim crosses the moon right to left; after it passes, 24 to 36 gold motes drift down from the star. Once per night, then calm
Reduced motionThe change is a short crossfade; the sleigh is a still vignette over the moon that fades; no motes, glints or swing

Decorating the tree ​

WhatRule
WhereClicking xmas_tree (small or grand) opens a small decorating view of the tree, with a tray of album items
What can hangFound entries of flowers, trees, gifts (received) and small finds (treasures). Not fish or bugs
Ornament lookA small round bauble with a thin gold rim, tinted by kind, holding the item's art: flowers pink, trees green, gifts lavender, small finds honey. Trees with an autumn drawing use it, so green trees stay apart
How manyThree a day; the tray shows how many are left as dots
HangingPick an item, hook points light up on the tree, pick one: the bauble arcs onto it, the branch dips, the bauble swings to rest, three glints, a friend reacts with a line
ReadingHover, focus or tap on a bauble shows a card with the item's art, name and book
KeepingOrnaments stay on the tree all winter and show on it in the yard. At the next lights they are taken down, so each December starts a fresh tree
Datagarden.ornaments ([{book, id, hook}]), garden.ornamentDay ({day, count}), garden.ornamentYear

Follow-up (2026-11-12, scenes before dates): the tree, the reindeer and Santa also show whenever the yard shows winter. Christmas night no longer needs lights: a winter yard, a snowy evening or night and the tree out, on any date. The tree grows each time that night comes together in sight, and the sleigh can fly once each time it grows; a restart the same night keeps it grand without the change. The desktop's tree turns grand and grows with the yard's. The tree can be decorated whenever it is out; a new December still starts a fresh tree.

Follow-up (2026-11-10): the decorating view lets a person take a bauble down from its card. It frees the hook and does not return the day's count. With three a day the tree fills in about four days, and taking one down lets it keep changing through the season.

Follow-up (2026-11-12): a hook is a bauble's centre and width as shares of the tree's drawing ([x, y, w] in catalog.json), so a hung bauble is the size of the painted ones and its rim is a thin line. Twelve hung baubles at that size do not fit between the small tree's painted ones, so five hooks sit on painted baubles and cover them; the other seven sit in the gaps, clear of every painted bauble and light. The grand tree's twelve hooks sit on twelve of its thirteen painted baubles. baubles lists each drawing's painted baubles, and the content tests check the hooks against them.

Building a snowman ​

WhatRule
WhenThe yard shows winter. A friend suggests it now and then, and it can be started from the play menu. Once a day
HowFriends roll a ball across the snow; the person taps the ball to help push (a short squash) or grabs and drags it to roll it themselves. The ball grows as it rolls and rolls more slowly as it grows
StackingThree balls (1 : 0.7 : 0.46). A full ball lifts in an arc onto the stack and settles with a small squash
DoneFive sparkles, a friend leans in; the person can put on a hat, a scarf and a carrot nose
ResultA snowman decor item is placed (it counts as receiving snowman) and keeps its accessories (decor.dress). It is winter-only decor
One at a timeThe yard has one built snowman; a new one replaces it (the old one "melts" with a friend's line). With the yard full and no snowman yet, building is not offered and a friend says the yard is full
TrailWhere a ball rolls, a faint, blurred blue shade stays and fades back into the snow over a few seconds. No grass, earth or crumbs

Footprints in the snow ​

WhatRule
AnimalsEight: hare, fox, water deer, raccoon dog, squirrel, sparrow, magpie, cat. Each print shape differs at a glance
WhenThe yard shows winter. One trail a day for sure; one more on a morning after snow (reconstructed from the deterministic autoWeather). From 12-26 to 01-07 only one a day
The trailFaint prints enter from the yard's edge, wind across the field and end at a bush or the edge. They fade like the snowman trail and are gone after a new snowfall or the next day
FollowingClicking the prints sends a friend along them, sniffing (6 to 8 s)
The endA tail shows for about a second behind the bush and whisks away with a puff of snow; birds flutter off instead. The animal is never shown whole
The findA small find waits there; the dig never comes up empty (a trail context like rainbow), and each animal leans to certain finds (magpie: shiny things; squirrel: pinecone, acorn teacup)
AlbumA new footprint book: each entry first shows the print and "Whose prints?"; following one fills in the tail drawing and the name
Reduced motionNo running; the tail appears and fades

The year-end letter ​

WhatRule
WhenOnce, on the first day the yard is open from 12-26 to 12-31
Who writesThe friend the person is closest to (highest closeness; ties go to the one earlier in the friends list)
How it comesA bubble ("I wrote you a letter!") and a letter card. With a mailbox in the yard the letter waits there; otherwise it opens from the bubble or the event chip
What it saysA few warm lines about the year together, with real facts: things found in the album this year, a tree grown together, how close they are, and days since meeting when known. Then it asks how the year was and what the person wants to do next year
Days since meetingNothing records it today. A bond gains met (the day it was first created) from now on; for friends without it the letter leaves that fact out
Without AILines from the string tables, in the friend's casual voice, with placeholders for the facts
With AIThe friend's voice writes it from the same facts; the facts and any earlier answer are flattened to one line, capped and labeled before they reach the AI
AnsweringA short text box (up to 200 characters) under the letter. Skipping is fine: the friend still ends with a warm line
Keptletters in state.json: {year, friend, text, answer, at}. The letter's own text is saved, so it reads the same after a restart and an AI is asked once. Only on this computer; the card has a way to delete the letter and the answer
Reading againUntil 01-07 the letter reopens from the event chip, or the mailbox when there is one. After that only the answer is kept for the recalls below
New YearOn the first day the yard is open from 01-01 to 01-07, the same friend brings the answer back: quotes it as plain text and cheers the person on. Never asks whether it was done
Next DecemberThe next year's letter recalls last year's answer to look back on
A friend that leftIts letters stay; the closest friend now brings the answer back

Follow-up (2026-11-10): the letter has its own chip (#letter-chip) beside the event chip and a row in the yard menu, so it no longer shares the event chip. The New Year cheer is its own card, and the answer counts as brought back only after the card shows. The friend's AI writes only while the yard is seen and never without a connection; without one the letter is made on the device from the app's own lines. The letter's text is cleared after January 7 by the minute check, and the answer stays.

Constraints ​

  • Repository rules: page modules act only in setup…(), every string in all four languages, Korean UI polite and friends casual, commands are one row of COMMANDS, no lock across a wait, text from outside labeled before an AI, a canvas repainted only when it changed.
  • New saved fields read as empty from older files.
  • Art follows the house style (softly sculpted miniature, true alpha), made with Codex from the existing art as reference; accepted art gets provenance in assets/README.md, rejected variants stay in scratch/.
  • The compact yard (300 to 640 px wide) must still read: ornaments, prints and the letter card are checked there.

Left to the builder ​

  • Exact timings, counts and colours beyond the ones above (they are starting points from the mockups).
  • Hook positions on the tree, how prints are drawn (static DOM marks or a canvas painted once per change), and the footprint art's exact size.
  • Wording of every line, within the voice rules.
  • How the decorating view and letter card are laid out, within the existing dialog styles.
  • Which finds each animal leans to, beyond the two examples.

Free and open source under the MIT license. Not affiliated with OpenAI; ChatGPT and Codex are trademarks of OpenAI.