1# Design
2 
3## Creating a uniform design in this app
4 
5Prefer to place standard fonts, sizes, colors, stack spacing, padding, rounding, animation timings, and more into a shared enum of constants, so they can be used by all views. This allows the app’s design to feel uniform and consistent, and be adjusted easily.
6 
7 
8## Requirements for flexible, accessible design
9 
10- Never use `UIScreen.main.bounds` to read available space; prefer alternatives such as `containerRelativeFrame()`, or `visualEffect()` as appropriate, or (if there is no alternative) `GeometryReader`.
11- Prefer to avoid fixed frames for views unless content can fit neatly inside; this can cause problems across different device sizes, different Dynamic Type settings, and more. Giving frames some flexibility is usually preferred.
12- Apple’s minimum acceptable tap area for interactions on iOS is 44x44. Ensure this is strictly enforced.
13 
14 
15## Standard system styling
16 
17- Strongly prefer to use `ContentUnavailableView` when data is missing or empty, rather than designing something custom.
18- When using `searchable()`, you can show empty results using `ContentUnavailableView.search` and it will include the search term they used automatically – there’s no need to use `ContentUnavailableView.search(text: searchText)` or similar.
19- If you need an icon and some text placed horizontally side by side, prefer `Label` over `HStack`.
20- Prefer system hierarchical styles (e.g. secondary/tertiary) over manual opacity when possible, so the system can adapt to the correct context automatically.
21- When using `Form`, wrap controls such as `Slider` in `LabeledContent` so the title and control are laid out correctly.
22- `LabeledContent` also works outside `Form` for any title-value display; it might be necessary to define a custom `LabeledContentStyle` for consistent layout across views.
23- When using `RoundedRectangle`, the default rounding style is `.continuous` – there is no need to specify it explicitly.
24 
25 
26## Ensuring designs work for everyone
27 
28- Use `bold()` instead of `fontWeight(.bold)`, because using `bold()` allows the system to choose the correct weight for the current context.
29- Only use `fontWeight()` for weights other than bold when there's an important reason - scattering around `fontWeight(.medium)` or `fontWeight(.semibold)` is counterproductive.
30- Avoid hard-coded values for padding and stack spacing unless specifically requested.
31- Avoid UIKit colors (`UIColor`) in SwiftUI code; use SwiftUI `Color` or asset catalog colors.
32- The font size `.caption2` is extremely small, and is generally best avoided. Even the font size `.caption` is on the small side, and should be used carefully.
33