Day

Fluent catalog for documentation examples

The UI snippets use app-generated res::str functions. These names are example messages, not built-in Day strings. Add the entries you need to resource/locales/en-US/app.ftl (or your app’s default locale), retaining your existing messages. Define the same keys and arguments in the other locales you ship.

The scaffold’s build.rs calls day_build::prebuild_project() and its library declares day::resources!();. In a child module, import crate::res; a separate binary imports your_app::res from its library. Start the app with res::window_options() so the catalog and saved language are available before the UI is built. See Localization for the complete setup.

id!(save_button) declares a stable ElementId independently of the catalog. It names a control for automation, while res::str::save() supplies its translated title. Recycled rows use .id_of(move || id!(item_row, slot.key())). See element IDs and accessibility.

File paths, route keys, protocol strings, and user-authored content are data, not catalog entries. The fixed sample amounts and weather readings below are illustrative fixtures. Bundled images and files in other examples require the corresponding resources in your project; reference them through res::images, res::vectors, res::fonts, and res::assets.

Example messages

Use this as a lookup for the snippets, not as a catalog to copy wholesale into a shipping app. Rename messages to suit your screen and give translators context. A guide with its own FTL block uses that block’s definitions.

a_quiet_caption = A quiet caption
about = About
about_app = About this app
account = Account
add = Add
add_one = Add one
api_example_org = api.example.org
app_title = Example app
archive = Archive
battery_percent = Battery: { $percent }%
battery_unknown = Battery status unavailable
bold = Bold
bottom = Bottom
brand = Brand
cancel = Cancel
caption = Caption
canvas_value = { $value }
chapter = Chapter
chapter_one = Chapter One
check = Check
city = City
click_count = { $count ->
    [one] One click
   *[other] { $count } clicks
    }
close = Close
connection_closed = Connection closed ({ $code }): { $reason }
counter = Counter
counter_value = Count: { $count }
cpu_usage = CPU usage
custom_size_sample = 18 pt
dark = Dark
decrement = Decrease count
delete = Delete
delete_body = This cannot be undone.
delete_item = Delete item
delete_item_hint = Permanently remove the selected item
delete_title = Delete this item?
discard_changes = Discard changes?
document_content = Document content
drafts = Drafts
drag = Drag
duplicate = Duplicate
edit = Edit
edition_name = { $edition } edition
email = Email
enable_reminders = Enable reminders
enabled = Enabled
everything = Everything
fetch = Fetch
file = File
font_sample = Aa Bb
forecast_rain = Rain later
first_label = a
flash_the_save_button = Flash the save button
good_morning = Good morning
greeting = Hello, { $name }!
grow = Grow
hello = Hello
hello_from_my_first_edit = Hello from my first edit
hello_native_world = Hello, native world
hi = Hi
hint = Changes are saved automatically.
home = Home
how_was_it = How was it?
http_status = HTTP status: { $status }
http_summary = HTTP { $status } · { $bytes } bytes
inbox = Inbox
increment = Increase count
item_100 = Item 100
large = Large
last_updated = Last updated
legalese = legalese
level = Level
library = Library
light = Light
lisbon = Lisbon
loading = Loading…
living_room = Living room
live_quote_title = { $symbol } — live
log_in = Log in
medium = Medium
menu_view = View
mon = Mon
more_actions = More actions
move_to = Move to
move_to_group = Move to group
my_app = My App
nairobi = Nairobi
name = Name
nav_controls = Controls
nav_home = Home
nav_library = Library
nav_settings = Settings
navigation_links = Open [**Navigate**](#navigate) or [Settings](#settings).
new = New
new_item = New Item
new_note = New Note
new_york = New York
next_unread = Next unread
nothing_selected = Nothing selected
notifications = Notifications
online = Online
open = Open…
open_42 = Open 42
open_album = Open album
operation_failed = Could not complete the operation: { $detail }
osaka = Osaka
overwrite = Overwrite?
password = Password
pause = Pause
pause_timer = Pause timer
percentage = { NUMBER($percent, maximumFractionDigits: 0) }%
pick = Pick
pick_a_tint = Pick a tint
pistachio = Pistachio
plan = Plan
play = Play
precipitation = { $percent }%
press = Press
price = Price
pro = Pro
profile = Profile
q3_chart_summary = Sales increased each month from July through September.
qty = Qty
quantity = Quantity
quit = Quit
rating_star = Rate { $stars } out of { $maximum } stars
rating_value = { $stars } / 5
read_me = Read me
received_bytes = Received { $bytes } bytes
record = Record
rectangle = Rectangle
refresh = Refresh
release_note = **New:** Read saved articles offline.
rename = Rename
right_click_me = Right-click me
sample_high = 15°
sample_high_tuesday = 22°
sample_label = x
sample_low = 9°
sample_low_tuesday = 12°
sample_order = Order #A1B2-C3D4
sample_price = { NUMBER($amount, minimumFractionDigits: 2, maximumFractionDigits: 2) }
sample_probability = 40%
sample_total = $1,240.00
san_francisco = San Francisco
save = Save
save_as = Save As…
save_hint = Save your changes
save_instructions = Save it as **notes.md** before you *quit*.
saved = Saved
screenshot = Screenshot
search_fruit = Search fruit…
search_sections = Search sections
second_label = b
send = Send
settings = Settings
settings_title = Settings
show_done = Show completed items
show_password = Show Password
size = Size
small = Small
snooze = Snooze
sound = Sound
stack = Stack
stand_up = Time to stand up
star = Star
standard_edition = Standard edition
start_timer = Start timer
start_typing = Start typing…
stop = Stop
stroke_width = Stroke width
subscribe = Subscribe
system = System
tap_me = Tap me
tell_me_your_name = Tell me your name
temperature = { NUMBER($degrees, maximumFractionDigits: 1) }°
temperature_celsius = { $degrees } °C
terms_blurb = Read the [terms of use](https://example.org/terms).
text_files = Text files
timer_done = Timer done
timer_done_body = Your five-minute timer has finished.
title = Title
total = Total
total_eur = { NUMBER($amount, minimumFractionDigits: 2, maximumFractionDigits: 2) } €
tue = Tue
type_or_pick_a_flavor = Type or pick a flavor
unstar = Unstar
untitled = Untitled
usd = USD
vanilla = Vanilla
view = View
view_both = View both
view_day = View day
view_grid = View grid
volume = Volume
volume_level = Volume level
wake_up = Wake up
weather_title = Weather
welcome_aboard = Welcome aboard
whispered = Whispered
write_a_message = Write a message…
your_name = Your name
about_credits = Created by the community.
about_tagline = Tools for sharing your work.
feeds = Feeds
nav_welcome = Welcome
not_on_this_platform = This view is unavailable on this platform.
pref_snap = Snap to grid
search = Search
settings_editing = Editing
settings_host = Server address
settings_unit = Temperature unit
settings_weather = Weather
smart_feeds = Smart feeds
today = Today
unit_c = Celsius
unit_f = Fahrenheit
unread_feed = Unread

Technical recipes

The task-guide modules are designated compilable examples. Each guide supplies a complete src/<module>.rs and its Fluent messages. Compile them together with this setup in a new apps/technical-recipes/ directory directly under the Day checkout. These are library recipes, not standalone apps. Keep every dependency on the same checkout and run the validator against the Day revision your app uses.

Create Cargo.toml:

[package]
name = "technical-recipes"
version = "0.1.0"
edition = "2024"

[workspace]

[lib]
name = "dayapp"

[dependencies]
day = { path = "../../crates/day", features = ["mock"] }
day-part-http = { path = "../../parts/day-part-http" }
day-part-fs = { path = "../../parts/day-part-fs" }
day-part-permissions = { path = "../../parts/day-part-permissions" }
day-part-local-notify = { path = "../../parts/day-part-local-notify" }

[build-dependencies]
day-build = { path = "../../crates/day-build" }

Create Day.toml (the title is packaging metadata; visible messages use the catalog):

schema = 1

[app]
id = "dev.daybrite.docs.technical-recipes"
title = "Technical recipes"
build = 1
targets = ["macos-appkit"]

[permissions]
notifications = true

Create build.rs:

fn main() {
    day_build::prebuild_project().expect("day-build: prebuild");
}

Create src/lib.rs:

day::resources!();

pub mod accessibility_recipe;
pub mod commands;
pub mod documents;
pub mod events;
pub mod http;
pub mod layout_recipe;
pub mod localization_recipe;
pub mod navigation_recipe;
pub mod notify;
pub mod permissions;
pub mod resource_recipe;
pub mod storage;
pub mod tree_recipe;

Create resource/locales/en/app.ftl with app_title = Technical recipes, followed by the catalog blocks from HTTP, storage, permissions, notifications, commands, and documents. Copy each guide’s marked complete module into the corresponding source file. Also copy the modules and catalogs from events/state, layout, navigation, localization, accessibility, and resources, and trees. Create the resource guide’s resource/assets/recipe_data.json fixture too. No additional helper types are needed.

From the app directory, run cargo check --all-targets and cargo clippy --all-targets -- -D warnings. From the repository root, the automated equivalent is:

python3 -B scripts/docs/verify-recipes.py

The validator extracts these exact blocks into a fresh repository-local workspace, compiles and lints every designated module, and runs synthetic command/prefs/file and mock interaction tests. Day dependencies resolve to this checkout. Third-party dependencies use Cargo’s offline cache by default; set CARGO_NET_OFFLINE=false to allow downloads on a fresh machine, as website CI does. The validator verifies the original repository lock remains unchanged. The examples do not send HTTP requests, post notifications, display permission prompts, or open user documents. The mock facade does not replace the OS implementation inside every part. The fixture store paths are redirected under the validator’s workspace.

All other Rust fences in the technical corpus are API excerpts or integration fragments unless explicitly designated by a tutorial or technical-example marker. They are not implicitly covered by this compilation result. The priority-guide excerpts have a separate compiler check:

python3 -B scripts/docs/verify-excerpts.py

That check supplies synthetic app functions, types, and resource fixtures for omitted context. It compiles the published blocks without making them standalone apps. The validation record summarizes the checked recipes, priority excerpts, and remaining unverified corpus.