5.4 KiB
5.4 KiB
Tasknest settings page design spec
Use this as a visual and interaction reference for another app's /settings page. Keep that app's existing setting names and save behavior; apply the layout and component language below.
Page structure
- Place the page inside the app's normal header and content shell. Tasknest's shell is at most 1180px wide, with 28px horizontal padding and 64px top padding. At widths up to 560px, horizontal padding becomes 18px and top padding 40px.
- Center the settings content in a single column, at most 680px wide. There is no settings sidebar.
- Begin with a small uppercase eyebrow, then a large
Settingsheading. The eyebrow uses the green accent, 0.74rem, bold weight, and 0.1em letter spacing. The heading uses Fraunces (or a similar friendly serif), bold, withclamp(2.3rem, 4vw, 3.5rem)and tight letter spacing. - Stack one card per topic with 24px between cards. Each card contains a short heading, optional one or two sentence explanation, its fields, and its own Save button. Related settings stay in the same card.
- The actual Tasknest order is Time zone, First-run help, Location & weather, Sick Day Mode, Hydration, Notifications / ntfy, and Fasting. Adapt the order to the other app's features.
Visual tokens
| Purpose | Light value | Dark value |
|---|---|---|
| Page canvas | #f7f7f3 |
#151b18 |
| Card surface | #ffffff |
#202923 |
| Main text | #25292e |
#e8eee9 |
| Muted text | #6d737a |
#b8c3bb |
| Border | #e6e8e3 |
#38443d |
| Primary green | #235943 |
Keep green buttons legible on the dark surface |
| Primary hover | #174333 |
A brighter green hover may be used |
| Link/accent in dark mode | — | #9bd5ae |
| Positive switch | #34c76a |
#34c76a |
Use DM Sans (or a similar clean sans serif) for body text and controls. Use Fraunces (or a similar warm serif) for page and card headings. The page should feel calm and spacious, with green as the only strong accent.
Cards and forms
- Card: 28px internal padding, 18px corner radius, a 1px border, white surface, and a soft shadow equivalent to
0 18px 45px rgba(29,43,37,.08). Avoid dense dividers between ordinary fields. - Card heading: serif, about 1.5rem, with 7px bottom margin. Description: muted color and concise copy.
- Form: one vertical grid column with 16px gaps. Controls and action buttons fill the available card width. Each card saves independently; show confirmation through the app's usual status message.
- Field: label above control with 6px spacing. Labels are 0.85rem, bold, and dark gray. Help text is smaller and muted. Input/select minimum height is 42px, with 9px rounded corners, 1px neutral border, and 9px 10px inner padding.
- Keep field errors beside their controls. Success and failure messages should be visible text, not only a color change.
Buttons and links
- Primary Save button: full width inside the card form, 46px minimum height, 19px horizontal padding, fully rounded pill shape, forest green fill, white bold 0.9rem text. Hover darkens the green, adds a soft shadow, and lifts by about 1px.
- Secondary action: same size and pill shape, transparent fill, green text, and a light green border. On hover it fills green and turns white. In dark mode use
#263c2efill,#b9edc8text, and#568466border. Use it for actions such asTest notificationorUse my current location. - Quiet action: plain, bold green text with an underlined hover/focus treatment. Use sparingly for low emphasis actions such as turning help off.
- Keyboard focus must have a clearly visible outline. Tasknest uses a 3px green-tinted outline with 3px offset on buttons.
Switch rows
Use these for on/off settings, with the native checkbox retained inside a full-row label.
- Row: pale green
#f8fbf8background,#e3e9e2border, 15px radius, at least 70px high, 13px 16px padding, and 18px gap between text and switch. Hover changes the border/background subtly. - Left side: bold 0.92rem setting name and a muted 0.77rem one-line explanation. Right side: 51 × 31px rounded track with a 27px white thumb.
- Off track is
#cfd5d0; on track is#34c76a. The thumb moves 20px. Keep the entire row tappable and show a visible focus ring on the track when tabbing. - Dark mode row is
#1b2a20with#3a4c3fborder; the off track is#627168. Respect reduced-motion preferences by removing thumb/hover transitions. - A switch changes the form value; the nearby Save button applies it. The interface should make that save step clear.
Responsive behavior and acceptance
- Stay in one column at all widths. On phones, preserve the 18px outer gutter and let cards/fields/buttons fill the content width. Long labels may wrap; the switch remains visible on the right.
- Preserve readable contrast and the same card hierarchy in dark mode. Input surfaces are darker than cards; Tasknest uses
#161d19for dark inputs and#536159for their borders. - Check at a narrow phone width and a desktop width. No horizontal page scrolling; all controls remain tappable. Tab reaches every field, switch, and button in a sensible order. Space toggles switches; Enter or click submits forms. Saved values remain correct after reload.
Source reference: planner/templates/planner/user_settings.html, frontend/src/styles/main.scss, and planner/templates/planner/base.html in this repository.