{
  "version": 1,
  "name": "Settings that explain themselves",
  "url": "https://swipefile.design/board/settings-that-explain-themselves/",
  "markdown_url": "https://swipefile.design/board/settings-that-explain-themselves/notes.md",
  "json_url": "https://swipefile.design/board/settings-that-explain-themselves/data.json",
  "pdf_url": "https://swipefile.design/board/settings-that-explain-themselves/export.pdf",
  "reference_count": 4,
  "unavailable_count": 0,
  "guidance": "Use these references for design principles. Follow the project brief and use original branding, content, and imagery. Captures document a particular date; they do not verify current product behavior.",
  "references": [
    {
      "slug": "shadcn-profile",
      "name": "shadcn/ui v3 — Profile form",
      "kind": "app",
      "archetype": "Forms & Onboarding",
      "summary": "A profile form keeps field explanations close to the controls they clarify.",
      "use_for": "Constrain form width and use inline explanations instead of a separate help panel.",
      "source_url": "https://v3.shadcn.com/examples/forms",
      "reference_url": "https://swipefile.design/ref/shadcn-profile/",
      "screenshot_url": "https://swipefile.design/_astro/full.BU4-9B7G.webp",
      "thumbnail_url": "https://swipefile.design/_astro/card.DK2khitu.webp",
      "captured": "2026-09-04",
      "capture_scope": "excerpt",
      "provenance": "demo",
      "tags": [
        "forms & onboarding",
        "navigation",
        "shadcn"
      ],
      "patterns": [
        "Forms & onboarding",
        "Navigation"
      ],
      "design_notes": {
        "surface": "Profile form",
        "nav": "A local settings list separates profile, account, appearance, notifications, and display.",
        "layout": "Settings navigation sits beside a constrained single-column form for username, email, bio, and links.",
        "density": "A constrained form column leaves room between groups while keeping labels and controls together.",
        "color": "White surfaces, light input borders, and a dark update button.",
        "typography": "Use clear vertical rhythm between fields while keeping labels and helper text together.",
        "pattern": "Constrain form width and use inline explanations instead of a separate help panel.",
        "states": "Public v3 settings demo with sample values; no profile was submitted.",
        "dont": "Adapt the interaction pattern to your own product. Do not copy brand assets, sample identities, proprietary text, or assume unseen states. Specify keyboard behavior, loading, empty, error, and narrow-screen layouts for your implementation."
      },
      "recreation_prompt": "# Design reference: shadcn/ui v3 — Profile form\nSource: https://v3.shadcn.com/examples/forms\nSwipefile reference: https://swipefile.design/ref/shadcn-profile/\nCaptured: 2026-09-04. This is a dated reference, not a claim about the current live product.\nCapture scope: a page excerpt. Do not infer unseen sections or interactions.\n\n## Objective\nAdapt the interaction and layout patterns below to my project. Use my own content and identity. Do not reproduce logos, proprietary copy, or brand assets.\n\n## Reference notes\n- surface: Profile form\n- nav: A local settings list separates profile, account, appearance, notifications, and display.\n- layout: Settings navigation sits beside a constrained single-column form for username, email, bio, and links.\n- density: A constrained form column leaves room between groups while keeping labels and controls together.\n- color: White surfaces, light input borders, and a dark update button.\n- typography: Use clear vertical rhythm between fields while keeping labels and helper text together.\n- pattern: Constrain form width and use inline explanations instead of a separate help panel.\n- states: Public v3 settings demo with sample values; no profile was submitted.\n- dont: Adapt the interaction pattern to your own product. Do not copy brand assets, sample identities, proprietary text, or assume unseen states. Specify keyboard behavior, loading, empty, error, and narrow-screen layouts for your implementation.\n\nUseful for: Constrain form width and use inline explanations instead of a separate help panel.\n\n## Acceptance criteria\n- Existing project conventions, design tokens, working functionality, and unrelated changes are preserved.\n- Two or three reference principles clearly support the user's task; conflicts are resolved in favor of usability and the existing product.\n- Reusable components and semantic HTML express the interface. Available licensed assets are used; important UI text is never rendered as a bitmap.\n- Every visible control has a defined behavior. Loading, empty, error, success, disabled, and long-content states are specified where relevant. Demo data is clearly labeled.\n- Navigation and content adapt at 375px, 768px, and 1440px without horizontal page overflow. Keyboard use, visible focus, labeled inputs, at least 44px touch targets, readable contrast, and reduced motion are supported.\n- Verification distinguishes rendered behavior from proposals and identifies anything still requiring a backend or external service.\n\n## Quality bar\nClear hierarchy, consistent spacing, restrained surfaces, and purposeful motion. Avoid decorative gradients, excessive cards, placeholder buttons, and invented metrics unless the project calls for them. Do not claim a feature is connected or tested without evidence."
    },
    {
      "slug": "shadcn-account",
      "name": "shadcn/ui v3 — Account preferences",
      "kind": "app",
      "archetype": "Forms & Onboarding",
      "summary": "Account preferences pair personal details with date and language controls in a short settings form.",
      "use_for": "Keep personal details and locale preferences together while explaining how each value is used.",
      "source_url": "https://v3.shadcn.com/examples/forms/account",
      "reference_url": "https://swipefile.design/ref/shadcn-account/",
      "screenshot_url": "https://swipefile.design/_astro/full.DKN7eB_1.webp",
      "thumbnail_url": "https://swipefile.design/_astro/card.CZrsLFpO.webp",
      "captured": "2026-09-04",
      "capture_scope": "excerpt",
      "provenance": "demo",
      "tags": [
        "forms & onboarding",
        "navigation",
        "shadcn"
      ],
      "patterns": [
        "Forms & onboarding",
        "Navigation"
      ],
      "design_notes": {
        "surface": "Account preferences",
        "nav": "Account is selected in the persistent settings list alongside profile and appearance.",
        "layout": "A local navigation rail sits beside a constrained form for name, date of birth, and preferred language.",
        "density": "A constrained form column leaves room between groups while keeping labels and controls together.",
        "color": "White surfaces, subtle borders, and a dark update action.",
        "typography": "Keep short fields aligned and place helper text directly below its control.",
        "pattern": "Keep personal details and locale preferences together while explaining how each value is used.",
        "states": "Public v3 account-settings demo with sample fields; no personal data was submitted.",
        "dont": "Adapt the interaction pattern to your own product. Do not copy brand assets, sample identities, proprietary text, or assume unseen states. Specify keyboard behavior, loading, empty, error, and narrow-screen layouts for your implementation."
      },
      "recreation_prompt": "# Design reference: shadcn/ui v3 — Account preferences\nSource: https://v3.shadcn.com/examples/forms/account\nSwipefile reference: https://swipefile.design/ref/shadcn-account/\nCaptured: 2026-09-04. This is a dated reference, not a claim about the current live product.\nCapture scope: a page excerpt. Do not infer unseen sections or interactions.\n\n## Objective\nAdapt the interaction and layout patterns below to my project. Use my own content and identity. Do not reproduce logos, proprietary copy, or brand assets.\n\n## Reference notes\n- surface: Account preferences\n- nav: Account is selected in the persistent settings list alongside profile and appearance.\n- layout: A local navigation rail sits beside a constrained form for name, date of birth, and preferred language.\n- density: A constrained form column leaves room between groups while keeping labels and controls together.\n- color: White surfaces, subtle borders, and a dark update action.\n- typography: Keep short fields aligned and place helper text directly below its control.\n- pattern: Keep personal details and locale preferences together while explaining how each value is used.\n- states: Public v3 account-settings demo with sample fields; no personal data was submitted.\n- dont: Adapt the interaction pattern to your own product. Do not copy brand assets, sample identities, proprietary text, or assume unseen states. Specify keyboard behavior, loading, empty, error, and narrow-screen layouts for your implementation.\n\nUseful for: Keep personal details and locale preferences together while explaining how each value is used.\n\n## Acceptance criteria\n- Existing project conventions, design tokens, working functionality, and unrelated changes are preserved.\n- Two or three reference principles clearly support the user's task; conflicts are resolved in favor of usability and the existing product.\n- Reusable components and semantic HTML express the interface. Available licensed assets are used; important UI text is never rendered as a bitmap.\n- Every visible control has a defined behavior. Loading, empty, error, success, disabled, and long-content states are specified where relevant. Demo data is clearly labeled.\n- Navigation and content adapt at 375px, 768px, and 1440px without horizontal page overflow. Keyboard use, visible focus, labeled inputs, at least 44px touch targets, readable contrast, and reduced motion are supported.\n- Verification distinguishes rendered behavior from proposals and identifies anything still requiring a backend or external service.\n\n## Quality bar\nClear hierarchy, consistent spacing, restrained surfaces, and purposeful motion. Avoid decorative gradients, excessive cards, placeholder buttons, and invented metrics unless the project calls for them. Do not claim a feature is connected or tested without evidence."
    },
    {
      "slug": "shadcn-notifications",
      "name": "shadcn/ui v3 — Notification settings",
      "kind": "app",
      "archetype": "Forms & Onboarding",
      "summary": "Notification preferences distinguish a primary delivery choice from individual email categories.",
      "use_for": "Separate mutually exclusive notification modes from independent subscription choices.",
      "source_url": "https://v3.shadcn.com/examples/forms/notifications",
      "reference_url": "https://swipefile.design/ref/shadcn-notifications/",
      "screenshot_url": "https://swipefile.design/_astro/full.CyOnGP-m.webp",
      "thumbnail_url": "https://swipefile.design/_astro/card.C4mJqiPN.webp",
      "captured": "2026-09-04",
      "capture_scope": "excerpt",
      "provenance": "demo",
      "tags": [
        "forms & onboarding",
        "navigation",
        "shadcn"
      ],
      "patterns": [
        "Forms & onboarding",
        "Navigation"
      ],
      "design_notes": {
        "surface": "Notification settings",
        "nav": "The active Notifications section remains visible alongside the other settings destinations.",
        "layout": "A narrow settings rail sits beside radio choices and separate rows of email switches with explanations.",
        "density": "A constrained form column leaves room between groups while keeping labels and controls together.",
        "color": "Monochrome controls and light bordered rows keep the focus on preference labels.",
        "typography": "Pair each toggle with a concise heading and a lower-contrast explanation.",
        "pattern": "Separate mutually exclusive notification modes from independent subscription choices.",
        "states": "Public v3 settings demo; no notification preferences were submitted.",
        "dont": "Adapt the interaction pattern to your own product. Do not copy brand assets, sample identities, proprietary text, or assume unseen states. Specify keyboard behavior, loading, empty, error, and narrow-screen layouts for your implementation."
      },
      "recreation_prompt": "# Design reference: shadcn/ui v3 — Notification settings\nSource: https://v3.shadcn.com/examples/forms/notifications\nSwipefile reference: https://swipefile.design/ref/shadcn-notifications/\nCaptured: 2026-09-04. This is a dated reference, not a claim about the current live product.\nCapture scope: a page excerpt. Do not infer unseen sections or interactions.\n\n## Objective\nAdapt the interaction and layout patterns below to my project. Use my own content and identity. Do not reproduce logos, proprietary copy, or brand assets.\n\n## Reference notes\n- surface: Notification settings\n- nav: The active Notifications section remains visible alongside the other settings destinations.\n- layout: A narrow settings rail sits beside radio choices and separate rows of email switches with explanations.\n- density: A constrained form column leaves room between groups while keeping labels and controls together.\n- color: Monochrome controls and light bordered rows keep the focus on preference labels.\n- typography: Pair each toggle with a concise heading and a lower-contrast explanation.\n- pattern: Separate mutually exclusive notification modes from independent subscription choices.\n- states: Public v3 settings demo; no notification preferences were submitted.\n- dont: Adapt the interaction pattern to your own product. Do not copy brand assets, sample identities, proprietary text, or assume unseen states. Specify keyboard behavior, loading, empty, error, and narrow-screen layouts for your implementation.\n\nUseful for: Separate mutually exclusive notification modes from independent subscription choices.\n\n## Acceptance criteria\n- Existing project conventions, design tokens, working functionality, and unrelated changes are preserved.\n- Two or three reference principles clearly support the user's task; conflicts are resolved in favor of usability and the existing product.\n- Reusable components and semantic HTML express the interface. Available licensed assets are used; important UI text is never rendered as a bitmap.\n- Every visible control has a defined behavior. Loading, empty, error, success, disabled, and long-content states are specified where relevant. Demo data is clearly labeled.\n- Navigation and content adapt at 375px, 768px, and 1440px without horizontal page overflow. Keyboard use, visible focus, labeled inputs, at least 44px touch targets, readable contrast, and reduced motion are supported.\n- Verification distinguishes rendered behavior from proposals and identifies anything still requiring a backend or external service.\n\n## Quality bar\nClear hierarchy, consistent spacing, restrained surfaces, and purposeful motion. Avoid decorative gradients, excessive cards, placeholder buttons, and invented metrics unless the project calls for them. Do not claim a feature is connected or tested without evidence."
    },
    {
      "slug": "shadcn-appearance",
      "name": "shadcn/ui v3 — Appearance settings",
      "kind": "app",
      "archetype": "Forms & Onboarding",
      "summary": "Appearance settings use illustrated light and dark choices beside font preferences.",
      "use_for": "Show the effect of appearance choices visually rather than relying on labels alone.",
      "source_url": "https://v3.shadcn.com/examples/forms/appearance",
      "reference_url": "https://swipefile.design/ref/shadcn-appearance/",
      "screenshot_url": "https://swipefile.design/_astro/full.DLsQJcmt.webp",
      "thumbnail_url": "https://swipefile.design/_astro/card.Cpjz-aGl.webp",
      "captured": "2026-09-04",
      "capture_scope": "excerpt",
      "provenance": "demo",
      "tags": [
        "forms & onboarding",
        "navigation",
        "shadcn"
      ],
      "patterns": [
        "Forms & onboarding",
        "Navigation"
      ],
      "design_notes": {
        "surface": "Appearance settings",
        "nav": "Appearance remains selected in the same navigation used by other settings screens.",
        "layout": "A settings rail sits next to a narrow form with a font picker and side-by-side theme previews.",
        "density": "A constrained form column leaves room between groups while keeping labels and controls together.",
        "color": "Neutral settings chrome with miniature light and dark interface previews.",
        "typography": "Give visual theme choices enough space to compare while keeping their labels close.",
        "pattern": "Show the effect of appearance choices visually rather than relying on labels alone.",
        "states": "Public v3 appearance-settings demo; no preference was submitted.",
        "dont": "Adapt the interaction pattern to your own product. Do not copy brand assets, sample identities, proprietary text, or assume unseen states. Specify keyboard behavior, loading, empty, error, and narrow-screen layouts for your implementation."
      },
      "recreation_prompt": "# Design reference: shadcn/ui v3 — Appearance settings\nSource: https://v3.shadcn.com/examples/forms/appearance\nSwipefile reference: https://swipefile.design/ref/shadcn-appearance/\nCaptured: 2026-09-04. This is a dated reference, not a claim about the current live product.\nCapture scope: a page excerpt. Do not infer unseen sections or interactions.\n\n## Objective\nAdapt the interaction and layout patterns below to my project. Use my own content and identity. Do not reproduce logos, proprietary copy, or brand assets.\n\n## Reference notes\n- surface: Appearance settings\n- nav: Appearance remains selected in the same navigation used by other settings screens.\n- layout: A settings rail sits next to a narrow form with a font picker and side-by-side theme previews.\n- density: A constrained form column leaves room between groups while keeping labels and controls together.\n- color: Neutral settings chrome with miniature light and dark interface previews.\n- typography: Give visual theme choices enough space to compare while keeping their labels close.\n- pattern: Show the effect of appearance choices visually rather than relying on labels alone.\n- states: Public v3 appearance-settings demo; no preference was submitted.\n- dont: Adapt the interaction pattern to your own product. Do not copy brand assets, sample identities, proprietary text, or assume unseen states. Specify keyboard behavior, loading, empty, error, and narrow-screen layouts for your implementation.\n\nUseful for: Show the effect of appearance choices visually rather than relying on labels alone.\n\n## Acceptance criteria\n- Existing project conventions, design tokens, working functionality, and unrelated changes are preserved.\n- Two or three reference principles clearly support the user's task; conflicts are resolved in favor of usability and the existing product.\n- Reusable components and semantic HTML express the interface. Available licensed assets are used; important UI text is never rendered as a bitmap.\n- Every visible control has a defined behavior. Loading, empty, error, success, disabled, and long-content states are specified where relevant. Demo data is clearly labeled.\n- Navigation and content adapt at 375px, 768px, and 1440px without horizontal page overflow. Keyboard use, visible focus, labeled inputs, at least 44px touch targets, readable contrast, and reduced motion are supported.\n- Verification distinguishes rendered behavior from proposals and identifies anything still requiring a backend or external service.\n\n## Quality bar\nClear hierarchy, consistent spacing, restrained surfaces, and purposeful motion. Avoid decorative gradients, excessive cards, placeholder buttons, and invented metrics unless the project calls for them. Do not claim a feature is connected or tested without evidence."
    }
  ]
}