Dako

How Little Things is built

2026-10-05 · technical note

October 15, 2026: current privacy notice

One Little Thing now keeps local counts of system-completed sharing, saving or copying activities; these do not prove delivery to friends. Company usage statistics are a separate choice, off by default and available only in versions with a configured service. They use post-consent daily lighting and sharing totals, without backfilling old records. Turning them off requests deletion; reports expire outside their report date's rolling 90-day window, subject to the deletion and network limits in the current Privacy Policy. Private iCloud sync remains a separate choice.

Historical text follows. Every older dated section below, including its descriptions of “current” behaviour, records that date's design and is preserved unchanged. Statements about no network requests, no analytics or collected data, earlier service providers, and planned features are historical; use the current policy for today's data practices.

October 10, 2026 update

The October 5 implementation snapshot below is historical. Signed public-content downloads are now enabled at content.dako.world with the verification key bundled in the app. Foreground automatic checks run at most once every 24 hours; Get new little things can download once with automatic updates off and leaves the switch off. The same public files are offered to everyone, without attaching daily records, energy choices, the app language or a user or device identifier.

Daily records remain in the local App Group store, without an app account or behavioral analytics. The current privacy manifest describes provider connection diagnostics and IP-derived coarse location for file delivery and security, rather than claiming no collected data. See the current privacy policy for the provider and retention boundaries. Daily reminders remain optional and local; server-sent new-content notifications are not enabled in this version.

The adopted library contains 85 stories: 49 use complete reviewed before/after frames and 36 retain layered geometry, plus a separate rest scene. Generic technique and material labels are used. Font and image sizes in the older snapshot below describe its dated build. The independent reduced-motion setting has been removed; system Reduce Motion and older saved preferences remain supported. Local builds and component tests do not establish a final App Store Archive or acceptance.

The normal record import and export controls have been removed from Settings. If the local store cannot be opened, the original database can be exported for technical diagnosis; this file cannot be imported inside the app. Optional private CloudKit record sync is being implemented on top of the existing local store. It requires the installed version to be configured and the user to confirm once; the default project setting remains off. Sync runs on launch, foreground return and explicit saved-record changes, with offline changes waiting for a later attempt. Completion, rest, undo and history deletion versions go only to the same Apple Account’s private database; painting image bodies are not uploaded. Turning it off preserves local and cloud copies, while an account change pauses work. There is no silent subscription or background synchronization in this version. Paid-team/container/profile setup, development and production schema, real-device verification and App Store privacy answers remain required before cloud-enabled release. Device backup is separate.

Historical implementation snapshot: October 5, 2026

Little Things is a small iOS app. It shows one small thing to do each day, with a painting. When you finish, you hold the painting and the light in it, a window, the sun or a lamp, comes on. This is how it is built, as of the repository on October 5, 2026.

Structure

The app is SwiftUI on iOS 17. The Xcode project has two targets, the app and a WidgetKit extension. Most logic lives in a local Swift package with two modules:

The package also builds for macOS, so its tests run on the Mac. A separate harness runs storage integration tests against the app's own model code on macOS.

Data

Records live in a SwiftData store inside an App Group container, so the app and the widget read the same file. iCloud sync is off. Schema V1 is frozen; V2 adds one optional field with a lightweight migration. DayService turns autosave off and wraps every change in a transaction that rolls back on failure. A damaged store falls back to memory, with the original kept for export. Backup is a versioned JSON file; import validates the whole file before merging.

Content updates

An optional download engine now exists. It uses HTTPS GET requests with an ephemeral URLSession, no cookies or stored credentials, and a fixed request header. CryptoKit verifies the signed content manifest and asset hashes; ImageIO checks downloaded artwork. A complete verified content pack is installed together, while the bundled library remains the offline fallback and accepted artwork is retained for past records.

The production download address and verification key are not configured, so the current release makes no content-update requests. When configured, the app checks in the foreground at most once a day, with an optional manual check. Automatic updates are on by default; switching them off stops new checks and downloads. Public file requests do not contain daily records, energy choices, the selected app language, or user and device identifiers.

There are no accounts, advertising or analytics. The current privacy manifest declares no tracking and no collected data. Before content downloads are activated, the hosting provider's connection logs and retention must be checked and the policy and App Store privacy disclosures reviewed. The current privacy policy describes this conditional service and the connection information received by its provider.

The draw

Each tier draws one item per day, and the draw stays fixed. The engine skips items shown in the last 7 days and avoids repeating a painting style across today's tiers or the previous 3 days.

Lighting the painting

Holding the painting drives a small state machine:

The Done button and VoiceOver run the same engine as an automatic hold.

Paintings

Each item has one 2:3 portrait painting and one reaction patch: the small region that differs after the light comes on. A Python export script checks the masters, finds the changed box, feathers its edge and writes its normalized position into actions.json. The bundle holds 85 paintings, 85 patches and one rest-day painting as HEIC, about 20 MB in all. The paintings are 1024×1536; the export script caps output at 1440×2160 and never upscales. The launch plan lists 2400×3600 masters exported at 1200×1800. The paintings are made with AI image tools from written prompts kept in per-item folders.

Widget, reminders, text

A medium home-screen widget shows today's item with a Done button backed by an App Intent. A circular lock-screen widget shows the lamp. Reminders are local notifications, 30 days ahead, 8 p.m. by default, skipped once the day is done or rested.

The interface is in English, Simplified and Traditional Chinese from one string catalog. Each language gets one font, subset to the characters the content uses: 827, 834 and 102. The three files total about 680 KB. A fontTools script cuts them, renames them to clear OFL reserved names, and checks the exported glyphs against the content.

Debug builds

Debug builds accept launch arguments that Release builds leave out: -demoTier 1|2|3, -demoLight 1, -demoRest 1, -demoTab review and -trialArt. They let us screenshot every state in the simulator.