<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Gaurav Guha</title>
    <description>The latest articles on DEV Community by Gaurav Guha (@greedy_reader).</description>
    <link>https://dev.to/greedy_reader</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F540016%2F33ad241c-46de-468c-b890-5fe3d25370c9.JPG</url>
      <title>DEV Community: Gaurav Guha</title>
      <link>https://dev.to/greedy_reader</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/greedy_reader"/>
    <language>en</language>
    <item>
      <title>How to customize UI kits without breaking accessibility</title>
      <dc:creator>Gaurav Guha</dc:creator>
      <pubDate>Wed, 18 Nov 2026 13:30:46 +0000</pubDate>
      <link>https://dev.to/greedy_reader/how-to-customize-ui-kits-without-breaking-accessibility-444b</link>
      <guid>https://dev.to/greedy_reader/how-to-customize-ui-kits-without-breaking-accessibility-444b</guid>
      <description>&lt;h2&gt;
  
  
  The problem
&lt;/h2&gt;

&lt;p&gt;You pull in a UI kit to move fast, then customize colors and spacing and suddenly focus states vanish, contrast fails in dark mode, and semantic buttons become plain &lt;code&gt;&amp;lt;div&amp;gt;&lt;/code&gt;s.&lt;/p&gt;

&lt;h2&gt;
  
  
  Start with tokens, not components
&lt;/h2&gt;

&lt;p&gt;The fastest way to rebrand without breaking things is to work at the token level: colors, spacing, radius, typography. Both the SaaS Starter Kit and AI UX Kit use CSS custom properties plus Tailwind tokens.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// tailwind.config.ts&lt;/span&gt;
&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;theme&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="n"&gt;extend&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;colors&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="n"&gt;primary&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
          &lt;span class="mi"&gt;50&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"var(--color-primary-50)"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
          &lt;span class="mi"&gt;100&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"var(--color-primary-100)"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
          &lt;span class="mi"&gt;600&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"var(--color-primary-600)"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="n"&gt;secondary&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
          &lt;span class="mi"&gt;100&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"var(--color-secondary-100)"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
          &lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"var(--color-secondary-200)"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;You customize the variables, not every component:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight css"&gt;&lt;code&gt;&lt;span class="cm"&gt;/* theme.css */&lt;/span&gt;
&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="nt"&gt;root&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nv"&gt;--color-primary-50&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mh"&gt;#f5f3ff&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nv"&gt;--color-primary-100&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mh"&gt;#e0ddff&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nv"&gt;--color-primary-600&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mh"&gt;#5b21ff&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="cm"&gt;/* your brand color */&lt;/span&gt;

  &lt;span class="nv"&gt;--color-secondary-100&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mh"&gt;#f4f4f5&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nv"&gt;--color-secondary-200&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mh"&gt;#e4e4e7&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Because components consume tokens, they inherit your brand automatically while keeping spacing, hierarchy, and focus styling intact.&lt;/p&gt;

&lt;h2&gt;
  
  
  Keep contrast in check
&lt;/h2&gt;

&lt;p&gt;Changing colors is the number one way to accidentally break accessibility.&lt;/p&gt;

&lt;p&gt;Safe pattern:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Change tokens in one place.&lt;/li&gt;
&lt;li&gt;Check contrast for key pairs:

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;primary-600&lt;/code&gt; on white&lt;/li&gt;
&lt;li&gt;text on &lt;code&gt;secondary-100&lt;/code&gt; / &lt;code&gt;secondary-200&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;focus rings vs. backgrounds&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;Test both light and dark themes if enabled.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Tools like &lt;code&gt;@axe-core/react&lt;/code&gt;, browser devtools, or design tools can help, but the kits already start from WCAG-conscious defaults: you're adjusting from a good baseline.&lt;/p&gt;

&lt;h2&gt;
  
  
  Don't remove focus, restyle it
&lt;/h2&gt;

&lt;p&gt;It's tempting to remove focus outlines completely. Instead, restyle them to match your brand. The kits ship components that already handle focus states; you just adjust tokens or utility classes.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Button&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ButtonLabel&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s2"&gt;"@/components/ui/primitives/button"&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nc"&gt;PrimaryAction&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;Button&lt;/span&gt;
      &lt;span class="n"&gt;action&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"primary"&lt;/span&gt;
      &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"focus-visible:ring-2 focus-visible:ring-primary-300 focus-visible:ring-offset-2"&lt;/span&gt;
    &lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;ButtonLabel&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="nc"&gt;Save&lt;/span&gt; &lt;span class="n"&gt;changes&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;ButtonLabel&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;Button&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;If you want global customization, do it in one place:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight css"&gt;&lt;code&gt;&lt;span class="cm"&gt;/* globals.css */&lt;/span&gt;
&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="nt"&gt;root&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nv"&gt;--focus-ring-color&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nf"&gt;rgba&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;91&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;33&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;255&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mf"&gt;0.35&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="nt"&gt;button&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="nt"&gt;focus-visible&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="nt"&gt;input&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="nt"&gt;focus-visible&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nt"&gt;role&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"button"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="nt"&gt;focus-visible&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nl"&gt;outline&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;2px&lt;/span&gt; &lt;span class="n"&gt;solid&lt;/span&gt; &lt;span class="nf"&gt;var&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;--focus-ring-color&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nl"&gt;outline-offset&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;2px&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This keeps keyboard navigation intact while still feeling on-brand.&lt;/p&gt;

&lt;h2&gt;
  
  
  Wrap, don't rewrite primitives
&lt;/h2&gt;

&lt;p&gt;The fastest way to break accessibility is to copy-paste internal component code and start editing. Better pattern: wrap the existing primitive.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="c1"&gt;// app/components/BrandButton.tsx&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Button&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ButtonProps&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;ButtonLabel&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s2"&gt;"@/components/ui/primitives/button"&lt;/span&gt;

&lt;span class="kd"&gt;type&lt;/span&gt; &lt;span class="nc"&gt;BrandButtonProps&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;ButtonProps&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;icon&lt;/span&gt;&lt;span class="o"&gt;?:&lt;/span&gt; &lt;span class="nc"&gt;React&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;ReactNode&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nc"&gt;BrandButton&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;children&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;icon&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;props&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;BrandButtonProps&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;Button&lt;/span&gt;
      &lt;span class="n"&gt;action&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"primary"&lt;/span&gt;
      &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"rounded-full px-5 py-2 text-sm shadow-sm"&lt;/span&gt;
      &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;props&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;icon&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;span&lt;/span&gt; &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"mr-2"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;icon&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;span&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;ButtonLabel&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;children&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;ButtonLabel&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;Button&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Now your app uses &lt;code&gt;BrandButton&lt;/code&gt; everywhere, but all the underlying ARIA attributes, focus behavior, and disabled state handling still come from the original primitive.&lt;/p&gt;

&lt;h2&gt;
  
  
  Customizing complex components
&lt;/h2&gt;

&lt;p&gt;Components like &lt;code&gt;PromptInput&lt;/code&gt; (AI UX Kit) or &lt;code&gt;MainSidebar&lt;/code&gt; (SaaS Starter Kit) are composed from primitives. To customize them safely:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Identify what should be configurable props (labels, placeholder, icons, badges, etc.).&lt;/li&gt;
&lt;li&gt;Use Tailwind &lt;code&gt;className&lt;/code&gt; overrides, not structural rewrites.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Example: customizing &lt;code&gt;PromptInput&lt;/code&gt; styling and copy:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nc"&gt;PromptInput&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="kd"&gt;type&lt;/span&gt; &lt;span class="nc"&gt;PromptInputProps&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s2"&gt;"@/components/ui/composites/prompt-input"&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nc"&gt;BrandedPromptInput&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;props&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;PromptInputProps&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;PromptInput&lt;/span&gt;
      &lt;span class="n"&gt;placeholder&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Ask our assistant anything about your workspace..."&lt;/span&gt;
      &lt;span class="n"&gt;outlined&lt;/span&gt;
      &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"bg-basic-white border border-primary-100 shadow-sm"&lt;/span&gt;
      &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;props&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;You've changed the look and feel without touching semantic structure, keyboard handling, or file attachment and audio logic.&lt;/p&gt;

&lt;h2&gt;
  
  
  Anti-patterns to avoid
&lt;/h2&gt;

&lt;p&gt;Common customization mistakes that break accessibility:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Turning everything into &lt;code&gt;&amp;lt;div&amp;gt;&lt;/code&gt;s:&lt;/strong&gt; Avoid &lt;code&gt;onClick&lt;/code&gt; on plain &lt;code&gt;div&lt;/code&gt; without role/keyboard handlers. Instead, use &lt;code&gt;&amp;lt;button&amp;gt;&lt;/code&gt;, &lt;code&gt;&amp;lt;a&amp;gt;&lt;/code&gt;, or wrap the existing &lt;code&gt;Button&lt;/code&gt;/&lt;code&gt;Link&lt;/code&gt; components.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Removing focus outlines completely:&lt;/strong&gt; Avoid &lt;code&gt;outline-none&lt;/code&gt; or &lt;code&gt;focus-visible:outline-none&lt;/code&gt; with no replacement. Instead, restyle focus outlines via tokens or utilities.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Hardcoding colors inside components:&lt;/strong&gt; Avoid &lt;code&gt;className="text-[#888]"&lt;/code&gt; scattered across files. Instead, use token-driven classes like &lt;code&gt;text-secondary-600&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Copy-pasting core components:&lt;/strong&gt; Avoid duplicating internal primitives just to tweak spacing. Instead, wrap in your own component and override via &lt;code&gt;className&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Safe customization checklist
&lt;/h2&gt;

&lt;p&gt;Before merging major visual changes:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Tokens&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;All brand color changes go through design tokens / CSS variables.&lt;/li&gt;
&lt;li&gt;Contrast is checked for primary text, buttons, and focus rings.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Focus&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Focus styles are visible on all interactive elements.&lt;/li&gt;
&lt;li&gt;No global &lt;code&gt;outline: none&lt;/code&gt; without a replacement.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Semantics&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Interactive elements use &lt;code&gt;&amp;lt;button&amp;gt;&lt;/code&gt;, &lt;code&gt;&amp;lt;a&amp;gt;&lt;/code&gt;, or components that wrap them.&lt;/li&gt;
&lt;li&gt;Icons used as buttons include accessible labels or are decorative only.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Structure&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Heavier customizations are done via wrappers, not internal rewrites.&lt;/li&gt;
&lt;li&gt;Layout changes don't hide or detach focusable elements.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Regression&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Key flows (auth, settings, chat) are tested with keyboard only.&lt;/li&gt;
&lt;li&gt;Screen reader smoke test on at least one platform (NVDA/VoiceOver).&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;This is a shorter version of a guide I wrote at Frontkit Studio. The &lt;a href="https://thefrontkit.com/blogs/customizing-ui-kits-without-breaking-accessibility?utm_source=devto&amp;amp;utm_medium=syndication" rel="noopener noreferrer"&gt;full post&lt;/a&gt; has the complete walkthrough.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>a11y</category>
      <category>tailwindcss</category>
      <category>react</category>
      <category>nextjs</category>
    </item>
    <item>
      <title>What a production kanban app actually requires in Next.js</title>
      <dc:creator>Gaurav Guha</dc:creator>
      <pubDate>Tue, 17 Nov 2026 13:35:41 +0000</pubDate>
      <link>https://dev.to/greedy_reader/what-a-production-kanban-app-actually-requires-in-nextjs-9gg</link>
      <guid>https://dev.to/greedy_reader/what-a-production-kanban-app-actually-requires-in-nextjs-9gg</guid>
      <description>&lt;p&gt;A weekend kanban board with a few columns and basic drag-and-drop is a one-week project. A production project management tool with sprints, multiple views, accessible drag-and-drop, real-time collaboration, and a credible task detail modal is more like ten to fourteen weeks.&lt;/p&gt;

&lt;h2&gt;
  
  
  What a real kanban app has to do
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Drag-and-drop that survives reality
&lt;/h3&gt;

&lt;p&gt;The interaction users judge the product on. The bar:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Touch support so the board works on phones&lt;/li&gt;
&lt;li&gt;Keyboard alternatives: Tab, Space to pick up, arrows to move, Space to drop, Escape to cancel&lt;/li&gt;
&lt;li&gt;Smooth animations with cards lifting visually and drop targets highlighting&lt;/li&gt;
&lt;li&gt;Autoscroll when dragging near column edges or board edges&lt;/li&gt;
&lt;li&gt;Multi-column dragging without layout jank&lt;/li&gt;
&lt;li&gt;Optimistic updates so dropping a card moves it immediately, with rollback on API error&lt;/li&gt;
&lt;li&gt;Accessibility announcements via &lt;code&gt;aria-live&lt;/code&gt; so screen reader users get stage-change feedback&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Don't write drag-and-drop yourself. &lt;code&gt;@hello-pangea/dnd&lt;/code&gt; (the maintained fork of &lt;code&gt;react-beautiful-dnd&lt;/code&gt;) and &lt;code&gt;dnd-kit&lt;/code&gt; are the two production-grade options.&lt;/p&gt;

&lt;h3&gt;
  
  
  Multiple views, not just a board
&lt;/h3&gt;

&lt;p&gt;Boards are great for status. Bad for deadlines, dependencies, and capacity. A complete kanban app needs:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Board view with columns by status&lt;/li&gt;
&lt;li&gt;List view for tabular sorting, bulk operations, and filtering&lt;/li&gt;
&lt;li&gt;Calendar view showing due dates in their actual time context&lt;/li&gt;
&lt;li&gt;Timeline / Gantt view for projects with dependencies&lt;/li&gt;
&lt;li&gt;Backlog view for prioritization separate from active work&lt;/li&gt;
&lt;li&gt;Workload view for capacity planning across the team&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Switching between views should preserve filters and search. Building one view well is a week; building five views well is two months.&lt;/p&gt;

&lt;h3&gt;
  
  
  Task detail modal with depth
&lt;/h3&gt;

&lt;p&gt;A title and description is not a task. The fields that survive contact with a real team:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Assignees (often multiple)&lt;/li&gt;
&lt;li&gt;Due dates with timezone awareness&lt;/li&gt;
&lt;li&gt;Priority (P1/P2/P3 or High/Medium/Low: pick one)&lt;/li&gt;
&lt;li&gt;Labels for flexible categorization&lt;/li&gt;
&lt;li&gt;Subtasks with checkboxes and percent complete&lt;/li&gt;
&lt;li&gt;Attachments with inline image previews&lt;/li&gt;
&lt;li&gt;Comments with @-mentions and resolution states&lt;/li&gt;
&lt;li&gt;Activity log showing changes&lt;/li&gt;
&lt;li&gt;Dependencies linking blocking tasks&lt;/li&gt;
&lt;li&gt;Custom fields per project&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The task detail modal is genuinely two weeks of work on its own. Underbuilding it is the most common reason kanban apps feel like toys.&lt;/p&gt;

&lt;h3&gt;
  
  
  Sprint planning for agile teams
&lt;/h3&gt;

&lt;p&gt;If you target any agile team:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Cycle entity with start date, end date, optional goal&lt;/li&gt;
&lt;li&gt;Backlog separate from the active board&lt;/li&gt;
&lt;li&gt;Drag from backlog → active sprint flow&lt;/li&gt;
&lt;li&gt;Capacity planning showing committed vs available hours&lt;/li&gt;
&lt;li&gt;Burndown chart during the sprint&lt;/li&gt;
&lt;li&gt;Velocity tracking across sprints&lt;/li&gt;
&lt;li&gt;Sprint review showing what shipped vs what didn't&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Sprint planning is its own mental model. Don't try to make it "a kanban with a start date." Build it as a sibling experience.&lt;/p&gt;

&lt;h3&gt;
  
  
  Real-time collaboration
&lt;/h3&gt;

&lt;p&gt;Less critical for v1 than founders think, but important once teams use it:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Presence indicators showing who's viewing the same board&lt;/li&gt;
&lt;li&gt;Live updates when someone else moves a card or edits a task&lt;/li&gt;
&lt;li&gt;Optimistic conflict resolution when two people edit the same task&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;WebSockets via Pusher or Ably is the fast path. Liveblocks if you want a higher-level abstraction. Skip in v1 if you're moving fast.&lt;/p&gt;

&lt;h3&gt;
  
  
  Filters that persist
&lt;/h3&gt;

&lt;p&gt;Filters look simple. Done right, they take a week:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Filter by assignee, label, priority, status, due date range&lt;/li&gt;
&lt;li&gt;Saved filter presets ("my high-priority tasks this week")&lt;/li&gt;
&lt;li&gt;URL-persistent filters so users can share a filtered view&lt;/li&gt;
&lt;li&gt;Apply across all views (board, list, calendar, timeline)&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;If you let users build a filter and lose it on reload, they will stop using filters.&lt;/p&gt;

&lt;h2&gt;
  
  
  Tech stack: kanban-specific decisions
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Drag-and-drop:&lt;/strong&gt; &lt;code&gt;@hello-pangea/dnd&lt;/code&gt; for board-style boards. &lt;code&gt;dnd-kit&lt;/code&gt; for more complex interactions (multi-board, custom collision detection).&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Real-time (if needed):&lt;/strong&gt; Pusher, Ably, or Liveblocks. Liveblocks is the most ergonomic but has its own pricing.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Charts (burndown, velocity):&lt;/strong&gt; Recharts. Don't reach for D3 unless you have a visualization specialist.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Calendar UI:&lt;/strong&gt; date-fns + custom month-view component. FullCalendar if you need week/day views.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Search:&lt;/strong&gt; Postgres &lt;code&gt;tsvector&lt;/code&gt; for v1. Algolia or Typesense at scale.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Database:&lt;/strong&gt; Postgres. Drizzle or Prisma. Foreign keys, not denormalized blobs.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Background jobs:&lt;/strong&gt; Inngest for due-date reminders and sprint roll-over automation.&lt;/p&gt;

&lt;h2&gt;
  
  
  Build path 1: from scratch (10 to 14 weeks)
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Week 1-2: Foundation.&lt;/strong&gt; Auth, app shell, project entity, task entity, basic CRUD.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Week 3-4: Board view with drag-and-drop.&lt;/strong&gt; Get this right; everything else depends on it. Use &lt;code&gt;@hello-pangea/dnd&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Week 5-6: Task detail modal.&lt;/strong&gt; All the fields above. Comments, activity, subtasks.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Week 7-8: Additional views.&lt;/strong&gt; List, calendar, timeline. Backlog as a separate flow.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Week 9-10: Sprints.&lt;/strong&gt; Cycle entity, backlog-to-sprint flow, burndown, velocity.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Week 11-12: Filters and search.&lt;/strong&gt; Persistent filters, full-text search, saved views.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Week 13-14: Polish.&lt;/strong&gt; Empty states, mobile, dark mode, accessibility, performance.&lt;/p&gt;

&lt;p&gt;Realistic for most teams is 14 to 18 weeks because the task detail modal alone fills 3 to 4 weeks.&lt;/p&gt;

&lt;h2&gt;
  
  
  Build path 2: using a kanban PM kit (2 weeks)
&lt;/h2&gt;

&lt;p&gt;A kit ships:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Board view with &lt;code&gt;@hello-pangea/dnd&lt;/code&gt; drag-and-drop (touch + keyboard accessible)&lt;/li&gt;
&lt;li&gt;List, calendar, Gantt timeline, and backlog views&lt;/li&gt;
&lt;li&gt;Task detail modal with assignees, dates, priorities, labels, subtasks, attachments, comments, activity, dependencies&lt;/li&gt;
&lt;li&gt;Sprint cycles with backlog flow, burndown, and velocity tracking&lt;/li&gt;
&lt;li&gt;Goals and roadmap views&lt;/li&gt;
&lt;li&gt;Workload view for capacity planning&lt;/li&gt;
&lt;li&gt;Persistent filters across views, with saved presets&lt;/li&gt;
&lt;li&gt;45 screens on Next.js 16, Tailwind v4, shadcn/ui&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;What remains:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Wire auth and database&lt;/li&gt;
&lt;li&gt;Real-time layer (Pusher, Liveblocks, or skip in v1)&lt;/li&gt;
&lt;li&gt;Your project-specific custom fields and workflows&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Two weeks of customization vs fourteen weeks of building.&lt;/p&gt;

&lt;h2&gt;
  
  
  Build path 3: full-stack kit with backend included
&lt;/h2&gt;

&lt;p&gt;Persisting drag-and-drop order, sprints and per-project task numbers is where kanban builds get slow. A full-stack kit ships that backend on Supabase:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;44 routes: boards, list, timeline, calendar and backlog views, cycles, modules, goals, roadmap, workload and analytics&lt;/li&gt;
&lt;li&gt;31 tables with migrations, row-level security, triggers and per-project task numbering&lt;/li&gt;
&lt;li&gt;Drag-and-drop that saves to the database, sprint cycles with velocity and burndown, and seven chart types&lt;/li&gt;
&lt;li&gt;Supabase Auth with email/password, Google and GitHub sign-in&lt;/li&gt;
&lt;li&gt;Server Actions for every mutation, across 16 action files&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Step-by-step from a kit
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Day 1-2: Setup, brand, database.&lt;/strong&gt; Schema migration. Replace seed data.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Day 3-4: Auth.&lt;/strong&gt; Wire your provider. Set up project membership roles.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Day 5-6: Customize task fields.&lt;/strong&gt; Adjust priorities, labels, statuses to match your team's workflow.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Day 7-8: Sprint configuration.&lt;/strong&gt; Set sprint length, working hours, holiday calendar.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Day 9-10: Real-time (optional).&lt;/strong&gt; Wire Pusher or Liveblocks if you need it for v1.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Day 11-12: Filters and saved views.&lt;/strong&gt; Configure default filters per role.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Day 13-14: Deploy and beta.&lt;/strong&gt; Vercel deploy, custom domain, beta test with one team.&lt;/p&gt;

&lt;h2&gt;
  
  
  Common pitfalls
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Building the board before the task model.&lt;/strong&gt; Tempting because the board is visible. Then the task detail modal needs fields the schema doesn't have. Define the full task model first.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Custom drag-and-drop.&lt;/strong&gt; Always worse than the library version. Use &lt;code&gt;@hello-pangea/dnd&lt;/code&gt; or &lt;code&gt;dnd-kit&lt;/code&gt; from day one.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Treating sprints as boards with start dates.&lt;/strong&gt; Sprints have backlogs, capacity planning, burndown, velocity, and retrospectives. Build them as a sibling concept.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Skipping keyboard accessibility.&lt;/strong&gt; Drag-and-drop is the hardest interaction to retrofit a11y into. Get it right first or use a library that does.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Underbuilding the task detail modal.&lt;/strong&gt; Two weeks of work shows up as "a card with a title and description shows up." That feels broken to anyone who's used Linear or Jira.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Building one view well, four views never.&lt;/strong&gt; Each view is a week. Plan all five up front so the data model supports them.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Filters that don't persist.&lt;/strong&gt; Build URL-persistent filters from day one. Retrofitting persistence into filter state means rewriting the entire filter system.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Ignoring empty states.&lt;/strong&gt; Day-one boards are empty. Empty columns with "drag a task here" copy and a CTA to create the first task are not optional polish: they're how the app introduces itself.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;This is a shorter version of a guide I wrote at Frontkit Studio. The &lt;a href="https://thefrontkit.com/blogs/how-to-build-a-kanban-app-in-nextjs-2026?utm_source=devto&amp;amp;utm_medium=syndication" rel="noopener noreferrer"&gt;full post&lt;/a&gt; has the complete walkthrough.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>nextjs</category>
      <category>react</category>
      <category>typescript</category>
      <category>tailwindcss</category>
    </item>
    <item>
      <title>Building production-ready AI interfaces with Next.js and React</title>
      <dc:creator>Gaurav Guha</dc:creator>
      <pubDate>Mon, 16 Nov 2026 13:32:12 +0000</pubDate>
      <link>https://dev.to/greedy_reader/building-production-ready-ai-interfaces-with-nextjs-and-react-4h7i</link>
      <guid>https://dev.to/greedy_reader/building-production-ready-ai-interfaces-with-nextjs-and-react-4h7i</guid>
      <description>&lt;p&gt;Building AI interfaces that feel polished and accessible takes more than a textarea and an API call. You need keyboard navigation, streaming responses that don't jank the UI, feedback capture for model improvement, and a theming system that survives dark mode. Most teams rebuild these patterns from scratch. Here are the components and patterns that actually ship.&lt;/p&gt;

&lt;h2&gt;
  
  
  Prompt input that handles files, suggestions, and voice
&lt;/h2&gt;

&lt;p&gt;The prompt input is the entry point. A production version needs auto-resizing, keyboard-navigable suggestions, file attachments with previews, voice input states, and focus management for screen readers.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;PromptInput&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;'@/components/ui/composites/prompt-input'&lt;/span&gt;

&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nc"&gt;ChatInterface&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;setPrompt&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;React&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;useState&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;''&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;files&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;setFiles&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;React&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;useState&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;handleSubmit&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;value&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;attachedFiles&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;AttachedFile&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="c1"&gt;// Send to your AI API&lt;/span&gt;
    &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sendToAI&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;value&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;attachedFiles&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;

  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;PromptInput&lt;/span&gt;
      &lt;span class="n"&gt;value&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;onChange&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;setPrompt&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;onSubmit&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;handleSubmit&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;placeholder&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Ask anything..."&lt;/span&gt;
      &lt;span class="n"&gt;suggestions&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'1'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'Summarize this document'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;category&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'actions'&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'2'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'Explain in simple terms'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;category&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'actions'&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;attachedFiles&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;files&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;onFileAttach&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;newFiles&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;setFiles&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;files&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;newFiles&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;actionButton&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"send"&lt;/span&gt;
      &lt;span class="n"&gt;showSuggestions&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Key behaviors baked in:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Textarea grows with content&lt;/li&gt;
&lt;li&gt;Arrow keys, Enter, and Escape navigate suggestions&lt;/li&gt;
&lt;li&gt;File previews with removal buttons&lt;/li&gt;
&lt;li&gt;Voice recording states with accessible labels&lt;/li&gt;
&lt;li&gt;Focus moves correctly when suggestions open or close&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Streaming responses without UI jank
&lt;/h2&gt;

&lt;p&gt;Streaming tokens require live regions for screen readers and smooth rendering. The response viewer handles markdown, code highlighting, and citations while announcing updates politely.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;ResponseViewer&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;'@/components/ui/composites/response-viewer'&lt;/span&gt;

&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nc"&gt;StreamingResponse&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;stream&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;stream&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;ReadableStream&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;setContent&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;React&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;useState&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;''&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

  &lt;span class="nc"&gt;React&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;useEffect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;reader&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;stream&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;getReader&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;decoder&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;TextDecoder&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

    &lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;readStream&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="k"&gt;while&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;done&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;value&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;reader&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;read&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;done&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;break&lt;/span&gt;

        &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;chunk&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;decoder&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;decode&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;value&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="nf"&gt;setContent&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;prev&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;prev&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="n"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
      &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="nf"&gt;readStream&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;stream&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;ResponseViewer&lt;/span&gt;
      &lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;format&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"markdown"&lt;/span&gt;
      &lt;span class="n"&gt;showCitations&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;citations&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nf"&gt;extractCitations&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;aria&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;live&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"polite"&lt;/span&gt;
      &lt;span class="n"&gt;aria&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;atomic&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"false"&lt;/span&gt;
    &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The &lt;code&gt;aria-live="polite"&lt;/code&gt; attribute lets screen readers announce updates without interrupting the user. The component handles markdown rendering, code syntax highlighting, and citation links internally.&lt;/p&gt;

&lt;h2&gt;
  
  
  Feedback loops for model improvement
&lt;/h2&gt;

&lt;p&gt;Capturing ratings and comments lets you improve the model. The feedback modal includes a 5-star rating with keyboard navigation, optional text field, accessible validation, and loading states.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;FeedbackModal&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;'@/components/ui/templates/modal/feedback-modal'&lt;/span&gt;

&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nc"&gt;AIResponseWithFeedback&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;responseId&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;responseId&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;showFeedback&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;setShowFeedback&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;React&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;useState&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;handleFeedbackSubmit&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;rating&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;number&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;feedback&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nb"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'/api/feedback'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;method&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'POST'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;stringify&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="n"&gt;responseId&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="n"&gt;rating&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;rating&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="n"&gt;feedback&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;feedback&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="nf"&gt;setShowFeedback&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;

  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&amp;gt;&lt;/span&gt;
      &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt; &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"flex items-center gap-2"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;ResponseViewer&lt;/span&gt; &lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
        &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;button&lt;/span&gt;
          &lt;span class="n"&gt;onClick&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;setShowFeedback&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
          &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"text-sm text-secondary-600 hover:text-primary-600"&lt;/span&gt;
        &lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
          &lt;span class="nc"&gt;Rate&lt;/span&gt; &lt;span class="kc"&gt;this&lt;/span&gt; &lt;span class="n"&gt;response&lt;/span&gt;
        &lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;button&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;

      &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;FeedbackModal&lt;/span&gt;
        &lt;span class="n"&gt;isOpen&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;showFeedback&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
        &lt;span class="n"&gt;onClose&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;setShowFeedback&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
        &lt;span class="n"&gt;onSubmit&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;handleFeedbackSubmit&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;/&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Wire your own &lt;code&gt;/api/feedback&lt;/code&gt; endpoint to persist the rating and comment alongside the response ID.&lt;/p&gt;

&lt;h2&gt;
  
  
  Token-driven theming with Tailwind
&lt;/h2&gt;

&lt;p&gt;Design tokens keep light and dark mode consistent. Map CSS custom properties to Tailwind color and spacing scales so theme changes propagate automatically.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="c1"&gt;// tailwind.config.js&lt;/span&gt;
&lt;span class="kd"&gt;module&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;exports&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;theme&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="n"&gt;extend&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;colors&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="n"&gt;primary&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
          &lt;span class="mi"&gt;50&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'var(--color-primary-50)'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
          &lt;span class="mi"&gt;100&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'var(--color-primary-100)'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
          &lt;span class="c1"&gt;// ... mapped from design token system&lt;/span&gt;
          &lt;span class="mi"&gt;600&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'var(--color-primary-600)'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="n"&gt;spacing&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="c1"&gt;// Tokenized spacing scale&lt;/span&gt;
        &lt;span class="s1"&gt;'token-1'&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'var(--spacing-token-1)'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="s1"&gt;'token-2'&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'var(--spacing-token-2)'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Define your tokens in &lt;code&gt;:root&lt;/code&gt; and &lt;code&gt;[data-theme="dark"]&lt;/code&gt; selectors. Components reference &lt;code&gt;primary-600&lt;/code&gt; or &lt;code&gt;token-2&lt;/code&gt; and inherit the correct values.&lt;/p&gt;

&lt;h2&gt;
  
  
  Complete prompt screen composition
&lt;/h2&gt;

&lt;p&gt;A full prompt screen combines centered input, suggested actions, topbar navigation, footer links, and mobile-responsive layout in one component.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;PromptScreen&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;'@/components/ui/recipes/prompt-submission/prompt-screen'&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nc"&gt;HomePage&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;PromptScreen&lt;/span&gt;
      &lt;span class="n"&gt;heading&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"What can I help you with?"&lt;/span&gt;
      &lt;span class="n"&gt;placeholder&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Ask anything..."&lt;/span&gt;
      &lt;span class="n"&gt;suggestedActions&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'1'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'Adjust lighting'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;icon&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'SunIcon'&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'2'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'Remove Background'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;icon&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'PhotoIcon'&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'3'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'Improve image quality'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;icon&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'SparklesIcon'&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;onPromptSubmit&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="n"&gt;router&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`/chat?prompt=${encodeURIComponent(prompt)}`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
      &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This handles keyboard flows, focus management, and responsive breakpoints without extra work.&lt;/p&gt;

&lt;h2&gt;
  
  
  Production checklist
&lt;/h2&gt;

&lt;p&gt;Before shipping, verify:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Keyboard navigation works for every interactive element&lt;/li&gt;
&lt;li&gt;Screen readers announce streaming responses via live regions&lt;/li&gt;
&lt;li&gt;Focus management handles modals and dynamic content insertion&lt;/li&gt;
&lt;li&gt;Error states are clear and actionable&lt;/li&gt;
&lt;li&gt;Loading states provide feedback during API calls&lt;/li&gt;
&lt;li&gt;Mobile experience is polished and touch-friendly&lt;/li&gt;
&lt;li&gt;Design tokens stay synced between design files and code&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Gotcha:&lt;/strong&gt; If you skip &lt;code&gt;aria-atomic="false"&lt;/code&gt; on the streaming viewer, some screen readers will re-read the entire response on every token chunk instead of announcing only the new text.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;This is a shorter version of a guide I wrote at Frontkit Studio. The &lt;a href="https://thefrontkit.com/blogs/building-production-ready-ai-interfaces-with-react-and-nextjs?utm_source=devto&amp;amp;utm_medium=syndication" rel="noopener noreferrer"&gt;full post&lt;/a&gt; has the complete walkthrough.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>nextjs</category>
      <category>react</category>
      <category>typescript</category>
      <category>tailwindcss</category>
    </item>
    <item>
      <title>EU Accessibility Act for Next.js: Common Failures and How to Fix Them</title>
      <dc:creator>Gaurav Guha</dc:creator>
      <pubDate>Sun, 15 Nov 2026 13:30:44 +0000</pubDate>
      <link>https://dev.to/greedy_reader/eu-accessibility-act-for-nextjs-common-failures-and-how-to-fix-them-3gfl</link>
      <guid>https://dev.to/greedy_reader/eu-accessibility-act-for-nextjs-common-failures-and-how-to-fix-them-3gfl</guid>
      <description>&lt;p&gt;If you build web apps with Next.js and sell software or subscriptions to customers in the EU, the EU Accessibility Act (Directive 2019/882) applies to you. Regulators in member states have started sending formal notices to companies shipping digital products without accessibility statements, and enterprise procurement teams are rejecting vendors who cannot verify compliance.&lt;/p&gt;

&lt;p&gt;Here is what the standard requires, the specific Next.js and React component patterns that fail it, and how to write the compliance documentation you need.&lt;/p&gt;

&lt;h2&gt;
  
  
  Who is in scope
&lt;/h2&gt;

&lt;p&gt;The law covers private-sector digital products and services sold to EU users:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Ecommerce websites and apps&lt;/strong&gt; selling physical or digital goods&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;SaaS subscriptions&lt;/strong&gt; with any consumer-facing component (signup, login, billing, support, marketing)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Banking and financial services&lt;/strong&gt; including fintech interfaces&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Transport services&lt;/strong&gt; (ticketing and schedules)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Telecommunications&lt;/strong&gt; customer portals&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Audiovisual media&lt;/strong&gt; and streaming&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;E-books and e-reader apps&lt;/strong&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Companies with fewer than 10 employees and under 2 million EUR in annual turnover qualify for a microenterprise exemption from substantive requirements, but they still have to provide accessibility information on request. Pure B2B platforms technically sit outside the direct scope, but enterprise procurement teams routinely demand compliance during vendor onboarding.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the law requires
&lt;/h2&gt;

&lt;p&gt;The law is performance-based. It relies on &lt;strong&gt;EN 301 549&lt;/strong&gt;, the European harmonized standard, which incorporates &lt;strong&gt;WCAG 2.1 Level AA&lt;/strong&gt; for web content. If your Next.js application satisfies WCAG 2.1 Level AA, you meet the baseline requirement for web content.&lt;/p&gt;

&lt;p&gt;Beyond the UI itself, you need:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;A public accessibility statement on your site&lt;/li&gt;
&lt;li&gt;A direct feedback mechanism for users to report accessibility barriers&lt;/li&gt;
&lt;li&gt;Testing records you can produce on request&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;A few common misconceptions to ignore:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Overlay widgets do not comply.&lt;/strong&gt; Accessibility overlay widgets that promise one-line script compliance do not meet EAA standards. Regulators and disability advocacy groups have explicitly rejected them.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Level AAA is not required.&lt;/strong&gt; Level AA is the benchmark.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Third-party certification is optional.&lt;/strong&gt; A documented self-assessment against WCAG 2.1 AA is legally acceptable.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  10 Next.js patterns that fail WCAG 2.1 AA
&lt;/h2&gt;

&lt;p&gt;Most Next.js apps built with Tailwind CSS and component libraries like shadcn/ui fail on a predictable set of criteria.&lt;/p&gt;

&lt;h3&gt;
  
  
  1. Color contrast (WCAG 1.4.3 and 1.4.11)
&lt;/h3&gt;

&lt;p&gt;Normal text requires a 4.5:1 contrast ratio against its background. Large text and UI component borders need 3:1.&lt;/p&gt;

&lt;p&gt;In Tailwind, &lt;code&gt;text-gray-500&lt;/code&gt; on &lt;code&gt;bg-white&lt;/code&gt; is 4.6:1 (barely passing). &lt;code&gt;text-gray-400&lt;/code&gt; is 2.8:1, which fails. In shadcn/ui setups, &lt;code&gt;text-muted-foreground&lt;/code&gt; is often borderline in light themes. Test every text token against every surface token where it renders.&lt;/p&gt;

&lt;h3&gt;
  
  
  2. Focus visibility (WCAG 2.4.7 and 1.4.11)
&lt;/h3&gt;

&lt;p&gt;Keyboard focus indicators must be visible with at least a 3:1 contrast ratio against the background.&lt;/p&gt;

&lt;p&gt;The default shadcn/ui focus ring class &lt;code&gt;focus-visible:ring-ring/50&lt;/code&gt; renders at 50% opacity. In most light themes, that drops contrast below 3:1. Replace it with full-opacity ring styles:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;ring-2 ring-ring ring-offset-2 ring-offset-background
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Test focus states in both light and dark mode.&lt;/p&gt;

&lt;h3&gt;
  
  
  3. Keyboard accessibility (WCAG 2.1.1 and 2.1.2)
&lt;/h3&gt;

&lt;p&gt;Every interactive control must be reachable and operable using only the keyboard.&lt;/p&gt;

&lt;p&gt;Do not attach &lt;code&gt;onClick&lt;/code&gt; handlers to &lt;code&gt;&amp;lt;div&amp;gt;&lt;/code&gt; or &lt;code&gt;&amp;lt;span&amp;gt;&lt;/code&gt; elements. Use &lt;code&gt;&amp;lt;button&amp;gt;&lt;/code&gt;, &lt;code&gt;&amp;lt;a&amp;gt;&lt;/code&gt;, or &lt;code&gt;&amp;lt;Link&amp;gt;&lt;/code&gt;. For complex controls like modals, dropdowns, and comboboxes, use Radix UI primitives (which power shadcn/ui). They manage focus trapping and arrow-key navigation out of the box.&lt;/p&gt;

&lt;h3&gt;
  
  
  4. Form labels (WCAG 3.3.2)
&lt;/h3&gt;

&lt;p&gt;Every input element needs a programmatically associated label.&lt;/p&gt;

&lt;p&gt;Placeholders are not labels. Wrapping an input in a &lt;code&gt;&amp;lt;div&amp;gt;&lt;/code&gt; with adjacent text does not link the label to the control. Use shadcn's &lt;code&gt;&amp;lt;Label&amp;gt;&lt;/code&gt; component with &lt;code&gt;htmlFor&lt;/code&gt; matching the input &lt;code&gt;id&lt;/code&gt;. If you use react-hook-form with shadcn's &lt;code&gt;&amp;lt;Form&amp;gt;&lt;/code&gt;, &lt;code&gt;&amp;lt;FormField&amp;gt;&lt;/code&gt; and &lt;code&gt;&amp;lt;FormLabel&amp;gt;&lt;/code&gt; wire this relationship automatically.&lt;/p&gt;

&lt;h3&gt;
  
  
  5. Heading hierarchy (WCAG 1.3.1 and 2.4.6)
&lt;/h3&gt;

&lt;p&gt;Pages must have a single &lt;code&gt;&amp;lt;h1&amp;gt;&lt;/code&gt; and avoid skipped levels.&lt;/p&gt;

&lt;p&gt;A frequent issue in dashboard apps is jumping from an &lt;code&gt;&amp;lt;h1&amp;gt;&lt;/code&gt; page title directly to &lt;code&gt;&amp;lt;h3&amp;gt;&lt;/code&gt; widget titles because &lt;code&gt;&amp;lt;h2&amp;gt;&lt;/code&gt; looked visually too large. Keep your heading tags sequential (&lt;code&gt;h1&lt;/code&gt; to &lt;code&gt;h2&lt;/code&gt; to &lt;code&gt;h3&lt;/code&gt;). Adjust visual size with Tailwind typography utilities rather than swapping HTML heading tags.&lt;/p&gt;

&lt;h3&gt;
  
  
  6. Image alternative text (WCAG 1.1.1)
&lt;/h3&gt;

&lt;p&gt;Informative images need descriptive alt text. Purely decorative images must have an empty alt attribute (&lt;code&gt;alt=""&lt;/code&gt;).&lt;/p&gt;

&lt;p&gt;Avoid generic labels like &lt;code&gt;alt="logo"&lt;/code&gt; (use the company name instead) or &lt;code&gt;alt="hero illustration"&lt;/code&gt;. Configure ESLint to flag missing &lt;code&gt;alt&lt;/code&gt; attributes on &lt;code&gt;next/image&lt;/code&gt; components.&lt;/p&gt;

&lt;h3&gt;
  
  
  7. Link purpose (WCAG 2.4.4)
&lt;/h3&gt;

&lt;p&gt;Link text must make sense when read out of context by a screen reader.&lt;/p&gt;

&lt;p&gt;Replace "Click here" or "Read more" with descriptive labels. Change "Read more" to "Read more about WCAG 2.2 AA", or change "Click here" to "View pricing plans".&lt;/p&gt;

&lt;h3&gt;
  
  
  8. Dynamic status messages (WCAG 4.1.3)
&lt;/h3&gt;

&lt;p&gt;Async status changes (toast alerts, loading states, form submission errors) must be announced to assistive tech without stealing user focus.&lt;/p&gt;

&lt;p&gt;Libraries like &lt;code&gt;sonner&lt;/code&gt; include live region announcements. For inline form validation errors, connect the error container's &lt;code&gt;id&lt;/code&gt; to the input using &lt;code&gt;aria-describedby&lt;/code&gt;.&lt;/p&gt;

&lt;h3&gt;
  
  
  9. Mobile reflow (WCAG 1.4.10)
&lt;/h3&gt;

&lt;p&gt;Content must fit a 320 CSS pixel viewport without requiring horizontal scrolling.&lt;/p&gt;

&lt;p&gt;Avoid hardcoded layout widths like &lt;code&gt;min-w-[800px]&lt;/code&gt;. Wrap data tables in containers with &lt;code&gt;overflow-x-auto&lt;/code&gt; and switch layout rows to flex columns on small breakpoints (&lt;code&gt;flex-col md:flex-row&lt;/code&gt;).&lt;/p&gt;

&lt;h3&gt;
  
  
  10. Touch target sizing (WCAG 2.5.8)
&lt;/h3&gt;

&lt;p&gt;Interactive elements need a target area of at least 24x24 CSS pixels, with 44x44 recommended.&lt;/p&gt;

&lt;p&gt;Small icon triggers often fail this requirement. If you need a visually compact indicator (such as an 8px pagination dot), place it inside an invisible 44px tap area:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;button&lt;/span&gt; &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"flex items-center justify-center size-11"&lt;/span&gt; &lt;span class="n"&gt;aria&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;label&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="sb"&gt;`Go to slide ${i + 1}`&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;span&lt;/span&gt; &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"size-2 rounded-full bg-primary"&lt;/span&gt; &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;button&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Remediation benchmarks
&lt;/h2&gt;

&lt;p&gt;Remediation effort scales with the number of unique templates and UI primitives:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;App size&lt;/th&gt;
&lt;th&gt;Audit time&lt;/th&gt;
&lt;th&gt;Remediation time&lt;/th&gt;
&lt;th&gt;Total cost (in-house)&lt;/th&gt;
&lt;th&gt;Total cost (consultant)&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Marketing site (5-10 pages)&lt;/td&gt;
&lt;td&gt;4 hours&lt;/td&gt;
&lt;td&gt;8-16 hours&lt;/td&gt;
&lt;td&gt;1-2 dev days&lt;/td&gt;
&lt;td&gt;$1,500-$3,000&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Small SaaS (15-30 screens)&lt;/td&gt;
&lt;td&gt;8 hours&lt;/td&gt;
&lt;td&gt;24-40 hours&lt;/td&gt;
&lt;td&gt;4-7 dev days&lt;/td&gt;
&lt;td&gt;$5,000-$10,000&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Mid-size dashboard (40-80 screens)&lt;/td&gt;
&lt;td&gt;16 hours&lt;/td&gt;
&lt;td&gt;60-120 hours&lt;/td&gt;
&lt;td&gt;10-20 dev days&lt;/td&gt;
&lt;td&gt;$15,000-$30,000&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Large platform (100+ screens)&lt;/td&gt;
&lt;td&gt;40 hours&lt;/td&gt;
&lt;td&gt;200+ hours&lt;/td&gt;
&lt;td&gt;30-50 dev days&lt;/td&gt;
&lt;td&gt;$40,000+&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Apps relying on standard headless primitives (like Radix) take significantly less time to remediate than apps using completely custom DOM trees for inputs and menus.&lt;/p&gt;

&lt;h2&gt;
  
  
  Publishing an accessibility statement
&lt;/h2&gt;

&lt;p&gt;Publish your statement at &lt;code&gt;/accessibility&lt;/code&gt; and link it in your footer. The statement should accurately describe your current status:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight markdown"&gt;&lt;code&gt;&lt;span class="gu"&gt;## Accessibility Statement for [Company Name]
&lt;/span&gt;
[Company Name] is committed to ensuring digital accessibility for people
with disabilities. We are continually improving the user experience for
everyone and applying the relevant accessibility standards.

&lt;span class="gu"&gt;### Conformance status
&lt;/span&gt;
[Product Name] is partially conformant with WCAG 2.1 Level AA.
"Partially conformant" means that some parts of the content do not fully
conform to the accessibility standard. [Or "fully conformant" if you've
verified everything passes.]

&lt;span class="gu"&gt;### Compatibility
&lt;/span&gt;
[Product Name] is designed to be compatible with the following assistive
technologies:
&lt;span class="k"&gt;- &lt;/span&gt;Latest versions of Chrome, Firefox, Safari, and Edge
&lt;span class="k"&gt;- &lt;/span&gt;VoiceOver on macOS and iOS
&lt;span class="k"&gt;- &lt;/span&gt;NVDA on Windows
&lt;span class="k"&gt;- &lt;/span&gt;TalkBack on Android

&lt;span class="gu"&gt;### Technical specifications
&lt;/span&gt;
[Product Name] relies on the following technologies for accessibility:
&lt;span class="k"&gt;- &lt;/span&gt;HTML
&lt;span class="k"&gt;- &lt;/span&gt;CSS
&lt;span class="k"&gt;- &lt;/span&gt;JavaScript
&lt;span class="k"&gt;- &lt;/span&gt;ARIA
&lt;span class="k"&gt;- &lt;/span&gt;Next.js, React, and Tailwind CSS

&lt;span class="gu"&gt;### Limitations and alternatives
&lt;/span&gt;
Despite our best efforts, some content may have minor accessibility
limitations:
&lt;span class="k"&gt;- &lt;/span&gt;[Honest list, e.g.: "Some legacy charts do not include text alternatives.
  We are addressing this in our next release."]

&lt;span class="gu"&gt;### Feedback
&lt;/span&gt;
We welcome your feedback on the accessibility of [Product Name]. Please
contact us if you encounter accessibility barriers:
&lt;span class="k"&gt;- &lt;/span&gt;Email: accessibility@yourcompany.com
&lt;span class="k"&gt;- &lt;/span&gt;Phone: [optional]
&lt;span class="k"&gt;- &lt;/span&gt;Postal address: [optional]

We aim to respond to feedback within 5 business days.

&lt;span class="gu"&gt;### Assessment approach
&lt;/span&gt;
[Company Name] assessed the accessibility of [Product Name] by the
following approaches:
&lt;span class="k"&gt;- &lt;/span&gt;Self-evaluation against WCAG 2.1 Level AA
&lt;span class="k"&gt;- &lt;/span&gt;Automated testing with axe-core
&lt;span class="k"&gt;- &lt;/span&gt;Manual testing with keyboard and screen reader
&lt;span class="k"&gt;- &lt;/span&gt;[Optional: third-party audit by [auditor name] on [date]]

&lt;span class="gu"&gt;### Date
&lt;/span&gt;
This statement was created on [date] using the [methodology].
Last reviewed: [date].
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Practical rollout checklist
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;Run automated axe-core scans across primary route groups (marketing, auth, main dashboard).&lt;/li&gt;
&lt;li&gt;Manually tab through critical funnels (checkout, signup, main feature flows) with the mouse unplugged.&lt;/li&gt;
&lt;li&gt;Publish &lt;code&gt;/accessibility&lt;/code&gt; using the markdown template above. An honest "partially conformant" declaration with known limitations is compliant under EAA rules, whereas having no statement is an immediate violation.&lt;/li&gt;
&lt;li&gt;Route an alias like &lt;code&gt;accessibility@yourdomain.com&lt;/code&gt; to your engineering or support inbox to meet the mandatory feedback requirement.&lt;/li&gt;
&lt;li&gt;If you receive an inquiry from an EU regulator, respond immediately. Most initial notices from member states (including Germany, France, the Netherlands, and Ireland) offer a 60- to 90-day corrective window to supply an accessibility statement and a remediation roadmap before statutory fines apply.&lt;/li&gt;
&lt;/ol&gt;




&lt;p&gt;&lt;em&gt;This is a shorter version of a guide I wrote at Frontkit Studio. The &lt;a href="https://thefrontkit.com/blogs/eu-accessibility-act-nextjs-developers-guide?utm_source=devto&amp;amp;utm_medium=syndication" rel="noopener noreferrer"&gt;full post&lt;/a&gt; has the complete walkthrough.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>nextjs</category>
      <category>react</category>
      <category>webdev</category>
      <category>a11y</category>
    </item>
    <item>
      <title>How to Build a Production-Ready SaaS in Next.js Without Spending Months on Chrome</title>
      <dc:creator>Gaurav Guha</dc:creator>
      <pubDate>Sat, 14 Nov 2026 13:31:04 +0000</pubDate>
      <link>https://dev.to/greedy_reader/how-to-build-a-production-ready-saas-in-nextjs-without-spending-months-on-chrome-1ob0</link>
      <guid>https://dev.to/greedy_reader/how-to-build-a-production-ready-saas-in-nextjs-without-spending-months-on-chrome-1ob0</guid>
      <description>&lt;h2&gt;
  
  
  The problem: you sit down to build your SaaS and realize you need 30 to 50 screens before writing a single line of business logic
&lt;/h2&gt;

&lt;p&gt;Auth, billing, dashboard, settings, team management, empty states, dark mode, mobile, accessibility, error states, loading states, role-based access, audit logs, and a marketing site that converts. That is the chrome every SaaS needs. Most teams spend 8 to 12 weeks building it from scratch. This guide walks the realistic path from zero to production: what to build, in what order, and where you can skip the boilerplate.&lt;/p&gt;

&lt;h2&gt;
  
  
  What a real Next.js SaaS actually needs
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Authenticated app shell
&lt;/h3&gt;

&lt;p&gt;Every SaaS lives inside a shell: sidebar, topbar, main content, profile menu, notifications. The shell carries:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Responsive sidebar that collapses on tablet and becomes a drawer on mobile&lt;/li&gt;
&lt;li&gt;Persistent topbar with search, notifications, and user menu&lt;/li&gt;
&lt;li&gt;Active route highlighting and breadcrumbs for nested routes&lt;/li&gt;
&lt;li&gt;Theme toggle that respects &lt;code&gt;prefers-color-scheme&lt;/code&gt; on first load&lt;/li&gt;
&lt;li&gt;Keyboard shortcuts for navigation (&lt;code&gt;g d&lt;/code&gt; for dashboard, &lt;code&gt;g s&lt;/code&gt; for settings, &lt;code&gt;?&lt;/code&gt; for help)&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The shell is 4 to 6 components but touches every screen. Get it wrong and the whole product feels off.&lt;/p&gt;

&lt;h3&gt;
  
  
  Auth screens
&lt;/h3&gt;

&lt;p&gt;Six screens at minimum:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Sign up with email/password and OAuth (Google, GitHub at minimum)&lt;/li&gt;
&lt;li&gt;Log in with remember-me and working "forgot password"&lt;/li&gt;
&lt;li&gt;Forgot password → email → reset flow&lt;/li&gt;
&lt;li&gt;Email verification or magic link&lt;/li&gt;
&lt;li&gt;Two-factor authentication setup&lt;/li&gt;
&lt;li&gt;Account-locked / suspicious-activity screens&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Each has loading states, error states, and accessibility quirks. Build once, use forever.&lt;/p&gt;

&lt;h3&gt;
  
  
  Dashboard
&lt;/h3&gt;

&lt;p&gt;The first screen after login. Most dashboards fail because they look impressive on day one and useless on day thirty. The pattern that holds:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Empty state for new users with clear next-action CTAs&lt;/li&gt;
&lt;li&gt;Three to five key metrics with prior-period comparison&lt;/li&gt;
&lt;li&gt;Recent activity feed showing what happened since last visit&lt;/li&gt;
&lt;li&gt;Quick actions (create, invite, configure) without navigation&lt;/li&gt;
&lt;li&gt;Charts summarizing the last week or month at a glance&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;A dashboard should answer "what should I do next?" in three seconds.&lt;/p&gt;

&lt;h3&gt;
  
  
  Settings
&lt;/h3&gt;

&lt;p&gt;The most underbuilt section. Categories that need to exist:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Profile: name, email, photo, preferences&lt;/li&gt;
&lt;li&gt;Account: email change, password change, delete account&lt;/li&gt;
&lt;li&gt;Team: invite, role assignment, removal, pending invites&lt;/li&gt;
&lt;li&gt;Billing: current plan, payment method, invoices, upgrade/downgrade&lt;/li&gt;
&lt;li&gt;Notifications: granular preferences across email, in-app, push&lt;/li&gt;
&lt;li&gt;Integrations: connected accounts (Slack, Google, Linear) with disconnect&lt;/li&gt;
&lt;li&gt;API keys: generate, label, revoke, scope&lt;/li&gt;
&lt;li&gt;Audit log: who did what, when&lt;/li&gt;
&lt;li&gt;Webhooks: endpoints, secrets, delivery history&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Most teams build profile + billing on day one and ignore the rest for six months. Then support tickets start.&lt;/p&gt;

&lt;h3&gt;
  
  
  Billing
&lt;/h3&gt;

&lt;p&gt;Stripe is the default. Screens you need:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Plan picker with feature comparison&lt;/li&gt;
&lt;li&gt;Checkout (embedded Stripe Checkout or Elements)&lt;/li&gt;
&lt;li&gt;Current plan view with renewal date and cost&lt;/li&gt;
&lt;li&gt;Invoices with download links&lt;/li&gt;
&lt;li&gt;Payment method update&lt;/li&gt;
&lt;li&gt;Upgrade/downgrade with proration or scheduling&lt;/li&gt;
&lt;li&gt;Cancellation with save-the-customer survey&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Connect Stripe webhooks for subscription events. Failed payment recovery emails alone save more revenue than any acquisition channel.&lt;/p&gt;

&lt;h3&gt;
  
  
  Marketing site
&lt;/h3&gt;

&lt;p&gt;Engineers want to skip it. Reality: marketing pages convert more than product UX in the first six months.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Landing page with hero, value props, social proof, pricing, FAQ, CTA&lt;/li&gt;
&lt;li&gt;Pricing page with comparison table and annual toggle&lt;/li&gt;
&lt;li&gt;Feature pages optimized for search&lt;/li&gt;
&lt;li&gt;About page, blog, docs, legal (privacy, terms, refund, cookie, support)&lt;/li&gt;
&lt;li&gt;Run Core Web Vitals on every page. Lighthouse should pass at 90+.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Tech stack: the defaults that hold up in 2026
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Framework:&lt;/strong&gt; Next.js 16, App Router, Server Components by default, route handlers for API endpoints&lt;br&gt;
&lt;strong&gt;UI library:&lt;/strong&gt; shadcn/ui + Tailwind CSS v4, Radix primitives for accessibility&lt;br&gt;
&lt;strong&gt;Auth:&lt;/strong&gt; Clerk (fastest setup, prettiest UI), Auth.js (open-source default), or Supabase Auth (pairs with database)&lt;br&gt;
&lt;strong&gt;Database:&lt;/strong&gt; Postgres via Supabase, Neon, or Vercel Postgres. Drizzle ORM (faster) or Prisma (better tooling)&lt;br&gt;
&lt;strong&gt;Payments:&lt;/strong&gt; Stripe (Razorpay if India-first)&lt;br&gt;
&lt;strong&gt;Hosting:&lt;/strong&gt; Vercel for DX. Self-host on Coolify or Railway if needed&lt;br&gt;
&lt;strong&gt;Email:&lt;/strong&gt; Resend or Postmark with React Email templates&lt;br&gt;
&lt;strong&gt;File storage:&lt;/strong&gt; Cloudflare R2 or Supabase Storage (S3 fallback)&lt;br&gt;
&lt;strong&gt;Background jobs:&lt;/strong&gt; Inngest (most ergonomic), Trigger.dev, or Vercel Cron&lt;br&gt;
&lt;strong&gt;Observability:&lt;/strong&gt; PostHog for product, Sentry for errors, Better Stack for uptime&lt;/p&gt;

&lt;p&gt;This stack is boring. That is a feature. Every component is well-documented, well-supported, and won't break in a year.&lt;/p&gt;

&lt;h2&gt;
  
  
  Build path 1: from scratch (8 to 12 weeks)
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Week 1-2:&lt;/strong&gt; Auth + app shell. Get login working, sidebar/topbar in place, empty dashboard. Resist building features yet.&lt;br&gt;
&lt;strong&gt;Week 3-4:&lt;/strong&gt; Settings + team. Profile, account, team invites. Most form complexity lives here.&lt;br&gt;
&lt;strong&gt;Week 5-6:&lt;/strong&gt; Billing. Stripe integration, plan picker, checkout, invoices, webhooks. Test failed payment flow before shipping.&lt;br&gt;
&lt;strong&gt;Week 7-8:&lt;/strong&gt; Core feature. Your SaaS differentiator. Chrome is built, you can focus.&lt;br&gt;
&lt;strong&gt;Week 9-10:&lt;/strong&gt; Marketing site. Landing, pricing, feature pages. SEO with proper schema.&lt;br&gt;
&lt;strong&gt;Week 11-12:&lt;/strong&gt; Polish. Empty states, error states, loading states, dark mode pass, accessibility audit, performance, deploy pipeline.&lt;/p&gt;

&lt;p&gt;Realistic for most teams is 14 to 18 weeks because of the long tail of "oh, we also need..." moments.&lt;/p&gt;

&lt;h2&gt;
  
  
  Build path 2: using a SaaS starter kit (1 week)
&lt;/h2&gt;

&lt;p&gt;A starter kit ships:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Auth screens (login, signup, forgot, reset, OTP, 2FA): accessible, themeable&lt;/li&gt;
&lt;li&gt;App shell (sidebar, topbar, mobile drawer) with dark mode wired&lt;/li&gt;
&lt;li&gt;Dashboard with empty states, metric cards, recent activity, quick actions&lt;/li&gt;
&lt;li&gt;Settings (profile, account, team, billing, notifications, API keys, audit log, webhooks)&lt;/li&gt;
&lt;li&gt;Billing UI (plan picker, checkout, invoices, payment method) ready for Stripe&lt;/li&gt;
&lt;li&gt;Marketing site (landing, pricing, features, about, blog index, docs index, legal)&lt;/li&gt;
&lt;li&gt;Component library (forms, tables, dialogs, command palette, toasts) WCAG AA&lt;/li&gt;
&lt;li&gt;35+ pages on Next.js 16, Tailwind v4, shadcn/ui&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Work that remains:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Wire your auth provider (Clerk, Auth.js, Supabase Auth) into existing screens&lt;/li&gt;
&lt;li&gt;Connect database and replace seed data with real queries&lt;/li&gt;
&lt;li&gt;Wire Stripe webhooks for actual billing&lt;/li&gt;
&lt;li&gt;Build your differentiating feature on top of existing chrome&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;That last bullet is the only week you couldn't have skipped.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step-by-step from the kit
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Day 1: Setup.&lt;/strong&gt; Clone, install, run locally. Configure environment variables. Replace logo, colors, brand name.&lt;br&gt;
&lt;strong&gt;Day 2: Auth wiring.&lt;/strong&gt; Pick provider. Replace auth handlers with real calls. Test login, signup, password reset end to end.&lt;br&gt;
&lt;strong&gt;Day 3: Database.&lt;/strong&gt; Set up Postgres (Supabase or Neon fastest). Define schema. Replace seed imports with Drizzle/Prisma queries.&lt;br&gt;
&lt;strong&gt;Day 4: Billing.&lt;/strong&gt; Create Stripe products and prices. Wire checkout flow. Set up webhook handler for subscription events. Test with Stripe test cards.&lt;br&gt;
&lt;strong&gt;Day 5: Your feature.&lt;/strong&gt; Build the one screen your SaaS exists to provide.&lt;br&gt;
&lt;strong&gt;Day 6: Marketing customization.&lt;/strong&gt; Rewrite landing copy, swap screenshots, update pricing. Run Lighthouse on every page.&lt;br&gt;
&lt;strong&gt;Day 7: Deploy.&lt;/strong&gt; Push to Vercel, configure domains, set up monitoring. Beta-test with one customer.&lt;/p&gt;

&lt;p&gt;The kit doesn't write your feature. It removes the eleven other weeks of work everyone has to do.&lt;/p&gt;

&lt;h2&gt;
  
  
  Common pitfalls
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Building features before chrome.&lt;/strong&gt; Tempting because features are fun. Don't. Chrome is harder than it looks, and feature work on weak chrome means rewriting both.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Skipping empty states.&lt;/strong&gt; Day-one users see empty everything. A blank dashboard with no copy looks broken. Design empty states first, then fill with real data.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Ignoring dark mode until late.&lt;/strong&gt; Dark mode pass at the end means refactoring colors throughout. Use design tokens from day one so dark mode is a switch, not a project.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Building settings as one page.&lt;/strong&gt; "We'll add tabs later." A single settings screen with 40 fields is unusable. Break into sub-pages on day one.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Doing auth yourself.&lt;/strong&gt; Almost no team should build auth from scratch in 2026. Edge cases (password reset tokens, OAuth callbacks, session refresh, 2FA recovery) are battle-tested by Clerk and Auth.js. Use them.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Underestimating the marketing site.&lt;/strong&gt; "Engineering will build it in a sprint" turns into a quarter of design and copy iterations. Start marketing build in parallel with product, not after.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Forgetting webhooks for Stripe.&lt;/strong&gt; Stripe Checkout updates Stripe's database, not yours. Without webhooks, your app doesn't know the user paid. Wire them on day one of billing.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Building team functionality without permissions.&lt;/strong&gt; A teammate who can view but not edit is impossible if your data model doesn't track roles. Define roles in the schema from day one.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;This is a shorter version of a guide I wrote at Frontkit Studio. The &lt;a href="https://thefrontkit.com/blogs/how-to-build-a-saas-in-nextjs-2026?utm_source=devto&amp;amp;utm_medium=syndication" rel="noopener noreferrer"&gt;full post&lt;/a&gt; has the complete walkthrough.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>nextjs</category>
      <category>saas</category>
      <category>typescript</category>
      <category>tailwindcss</category>
    </item>
    <item>
      <title>How to Build Streaming UI for AI Responses in React</title>
      <dc:creator>Gaurav Guha</dc:creator>
      <pubDate>Thu, 12 Nov 2026 13:31:10 +0000</pubDate>
      <link>https://dev.to/greedy_reader/how-to-build-streaming-ui-for-ai-responses-in-react-44li</link>
      <guid>https://dev.to/greedy_reader/how-to-build-streaming-ui-for-ai-responses-in-react-44li</guid>
      <description>&lt;p&gt;AI responses take 5 to 30 seconds to generate. Without streaming, users stare at a spinner the entire time. Streaming UI sends tokens as they arrive so the first word appears in 200 to 500 milliseconds.&lt;/p&gt;

&lt;h2&gt;
  
  
  How Streaming Works Under the Hood
&lt;/h2&gt;

&lt;p&gt;Most LLM providers stream via Server-Sent Events (SSE) over a single HTTP connection. Each event carries a small chunk:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"choices"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"delta"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"Hello"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"choices"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"delta"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;" there"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"choices"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"delta"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"! How"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;DONE&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The frontend reads the response body as a readable stream, decodes chunks, and appends them to the accumulated text:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;streamResponse&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;response&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nb"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'/api/chat'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="n"&gt;method&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'POST'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;stringify&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;prompt&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;reader&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;getReader&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;decoder&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;TextDecoder&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="n"&gt;accumulated&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;''&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="k"&gt;while&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;done&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;value&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;reader&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;read&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;done&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;break&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;chunk&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;decoder&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;decode&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;value&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;stream&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="n"&gt;accumulated&lt;/span&gt; &lt;span class="o"&gt;+=&lt;/span&gt; &lt;span class="nf"&gt;parseChunk&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="nf"&gt;setContent&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;accumulated&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The hard part isn't receiving data. It's rendering partial Markdown, code blocks, and tables without flicker or layout shift.&lt;/p&gt;

&lt;h2&gt;
  
  
  Rendering Partial Markdown Safely
&lt;/h2&gt;

&lt;p&gt;A naive renderer reparses on every token. That breaks bold tags, leaves code fences unclosed, and invalidates tables. Buffer incomplete structures and only render when you hit a safe boundary.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nc"&gt;StreamingMarkdown&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;chunks&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;isStreaming&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;rendered&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;setRendered&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;useState&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;''&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;bufferRef&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;useRef&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;''&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="nf"&gt;useEffect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="n"&gt;bufferRef&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;current&lt;/span&gt; &lt;span class="o"&gt;+=&lt;/span&gt; &lt;span class="n"&gt;chunks&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;safeContent&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;sanitizePartialMarkdown&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;bufferRef&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;current&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="nf"&gt;setRendered&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;markdownToHtml&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;safeContent&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;chunks&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt;
      &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"prose"&lt;/span&gt;
      &lt;span class="n"&gt;dangerouslySetInnerHTML&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;__html&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;rendered&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;aria&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;live&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"polite"&lt;/span&gt;
      &lt;span class="n"&gt;aria&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;busy&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;isStreaming&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;sanitizePartialMarkdown&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="c1"&gt;// Close any open bold/italic tags&lt;/span&gt;
  &lt;span class="c1"&gt;// Close any open code fences&lt;/span&gt;
  &lt;span class="c1"&gt;// Remove incomplete table rows&lt;/span&gt;
  &lt;span class="c1"&gt;// Buffer incomplete list items&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;cleanedText&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;For code blocks, defer syntax highlighting until the closing fence arrives. Re-highlighting on every chunk is expensive for long blocks.&lt;/p&gt;

&lt;h2&gt;
  
  
  Streaming Citations
&lt;/h2&gt;

&lt;p&gt;Citations often reference content that appears later in the stream. Render inline markers immediately, then populate the reference panel when full citation objects arrive:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nc"&gt;StreamingWithCitations&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;isStreaming&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;citations&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;parseCitations&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt; &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"prose"&lt;/span&gt; &lt;span class="n"&gt;aria&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;live&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"polite"&lt;/span&gt; &lt;span class="n"&gt;aria&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;busy&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;isStreaming&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;citations&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;length&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt; &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"citations-panel"&lt;/span&gt; &lt;span class="n"&gt;aria&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;label&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Sources"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
          &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;citations&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;citation&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;i&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
            &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;a&lt;/span&gt; &lt;span class="n"&gt;key&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;i&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="n"&gt;href&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;citation&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;url&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"citation-card"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
              &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;span&lt;/span&gt; &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"citation-number"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;i&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;span&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
              &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;span&lt;/span&gt; &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"citation-title"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;citation&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;title&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;span&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
              &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;span&lt;/span&gt; &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"citation-domain"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;citation&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;domain&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;span&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
            &lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;a&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
          &lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
        &lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Stream Controls Users Expect
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Stop Button
&lt;/h3&gt;

&lt;p&gt;Visible during streaming. Aborts generation and keeps what arrived.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nc"&gt;StreamControls&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;isStreaming&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;onStop&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;onRetry&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt; &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"flex gap-2"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;isStreaming&lt;/span&gt; &lt;span class="o"&gt;?&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;button&lt;/span&gt; &lt;span class="n"&gt;onClick&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;onStop&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="n"&gt;aria&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;label&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Stop generating"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
          &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;StopIcon&lt;/span&gt; &lt;span class="n"&gt;aria&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;hidden&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"true"&lt;/span&gt; &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
          &lt;span class="nc"&gt;Stop&lt;/span&gt;
        &lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;button&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;button&lt;/span&gt; &lt;span class="n"&gt;onClick&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;onRetry&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="n"&gt;aria&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;label&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Regenerate response"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
          &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;RefreshIcon&lt;/span&gt; &lt;span class="n"&gt;aria&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;hidden&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"true"&lt;/span&gt; &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
          &lt;span class="nc"&gt;Retry&lt;/span&gt;
        &lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;button&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Copy and Format Toggle
&lt;/h3&gt;

&lt;p&gt;Show copy after streaming completes. Let users switch between rendered Markdown, raw Markdown, and plain text without regenerating.&lt;/p&gt;

&lt;h2&gt;
  
  
  Accessibility Requirements
&lt;/h2&gt;

&lt;p&gt;Streaming content breaks screen readers if handled poorly. Use these patterns for WCAG AA:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt; &lt;span class="n"&gt;aria&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;live&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"polite"&lt;/span&gt; &lt;span class="n"&gt;aria&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;atomic&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"false"&lt;/span&gt; &lt;span class="n"&gt;aria&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;busy&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;isStreaming&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;streamedContent&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;aria-live="polite"&lt;/code&gt; announces changes without interrupting&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;aria-atomic="false"&lt;/code&gt; reads only new content, not the entire region&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;aria-busy="true"&lt;/code&gt; holds announcements until streaming completes&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Don't steal focus from the prompt input when a response starts. Debounce announcements to 2 to 3 second intervals. Stop, retry, and copy buttons must be keyboard accessible with logical tab order.&lt;/p&gt;

&lt;h2&gt;
  
  
  Using the Vercel AI SDK
&lt;/h2&gt;

&lt;p&gt;The Vercel AI SDK handles the streaming connection and state. You provide the UI layer:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="s1"&gt;'use client'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;useChat&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;'ai/react'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nc"&gt;Chat&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;input&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;handleInputChange&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;handleSubmit&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;isLoading&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;stop&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;useChat&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;message&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt; &lt;span class="n"&gt;key&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="n"&gt;role&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;role&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s1"&gt;'assistant'&lt;/span&gt; &lt;span class="o"&gt;?&lt;/span&gt; &lt;span class="s1"&gt;'status'&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;undefined&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
          &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;strong&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;role&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s1"&gt;'user'&lt;/span&gt; &lt;span class="o"&gt;?&lt;/span&gt; &lt;span class="s1"&gt;'You'&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'Assistant'&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;strong&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
          &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;

      &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;form&lt;/span&gt; &lt;span class="n"&gt;onSubmit&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;handleSubmit&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;input&lt;/span&gt;
          &lt;span class="n"&gt;value&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;input&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
          &lt;span class="n"&gt;onChange&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;handleInputChange&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
          &lt;span class="n"&gt;placeholder&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Ask something..."&lt;/span&gt;
          &lt;span class="n"&gt;aria&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;label&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"Chat prompt"&lt;/span&gt;
        &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;isLoading&lt;/span&gt; &lt;span class="o"&gt;?&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
          &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;button&lt;/span&gt; &lt;span class="kd"&gt;type&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"button"&lt;/span&gt; &lt;span class="n"&gt;onClick&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;stop&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="nc"&gt;Stop&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;button&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
          &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;button&lt;/span&gt; &lt;span class="kd"&gt;type&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"submit"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="nc"&gt;Send&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;button&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;form&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;div&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Anti-Patterns to Avoid
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Layout thrash:&lt;/strong&gt; Each token resizes the container and pushes content down. Fix with a minimum height on the response container and scroll the container, not the page.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;No loading state before first token:&lt;/strong&gt; TTFT can be seconds. Show a typing indicator or skeleton immediately on submit.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Flickering Markdown:&lt;/strong&gt; Re-parsing every token toggles formatting on and off. Buffer and re-render only on whitespace or sentence boundaries.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;No stop button:&lt;/strong&gt; Users can't abort irrelevant long responses. Keep a prominent stop button visible during streaming.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Losing partial responses on error:&lt;/strong&gt; If the stream fails mid-response, don't discard what arrived. Show the partial content with an error message and retry option.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;This is a shorter version of a guide I wrote at Frontkit Studio. The &lt;a href="https://thefrontkit.com/blogs/what-is-streaming-ui-in-ai-applications?utm_source=devto&amp;amp;utm_medium=syndication" rel="noopener noreferrer"&gt;full post&lt;/a&gt; has the complete walkthrough.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>react</category>
      <category>ai</category>
      <category>streaming</category>
      <category>a11y</category>
    </item>
    <item>
      <title>shadcn/ui vs MUI in 2026: Styling, Accessibility, and Component Trade-offs for SaaS</title>
      <dc:creator>Gaurav Guha</dc:creator>
      <pubDate>Tue, 10 Nov 2026 13:31:43 +0000</pubDate>
      <link>https://dev.to/greedy_reader/shadcnui-vs-mui-in-2026-styling-accessibility-and-component-trade-offs-for-saas-pdd</link>
      <guid>https://dev.to/greedy_reader/shadcnui-vs-mui-in-2026-styling-accessibility-and-component-trade-offs-for-saas-pdd</guid>
      <description>&lt;p&gt;Choosing a component library shapes your development speed, design flexibility, and long-term maintenance cost. Get it wrong and you spend months fighting the framework instead of building your product.&lt;/p&gt;

&lt;p&gt;As of September 2026, the two dominant React component libraries are &lt;strong&gt;shadcn/ui&lt;/strong&gt; and &lt;strong&gt;Material UI (MUI)&lt;/strong&gt;. They solve the same problem with fundamentally different approaches. Here's how they compare across the dimensions that matter for SaaS.&lt;/p&gt;

&lt;h2&gt;
  
  
  What Changed in 2026
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;MUI is on v9&lt;/strong&gt; (shipped April 2026, no v8). Emotion remains the default styling engine; zero-runtime Pigment CSS is opt-in and pre-1.0.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;MUI still implements Material Design 2&lt;/strong&gt;, not Material Design 3. M3 support is tracked in an open GitHub issue.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Joy UI is on hold&lt;/strong&gt;. MUI recommends Material UI for new projects.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;shadcn/ui is no longer Radix-only&lt;/strong&gt;. You can build on Base UI, React Aria, or Radix primitives.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Base UI reached v1&lt;/strong&gt; in December 2025.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;shadcn/ui runs on Tailwind CSS v4 and React 19&lt;/strong&gt;, and includes Recharts-based chart components.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Adoption is neck and neck&lt;/strong&gt;: ~124k GitHub stars for shadcn/ui vs ~99k for MUI. On npm, &lt;code&gt;@mui/material&lt;/code&gt; gets ~7.5M weekly downloads; the &lt;code&gt;shadcn&lt;/code&gt; CLI gets ~6.8M (CLI downloads undercount real usage since components are copied into your project).&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Styling Approach: Tailwind vs CSS-in-JS
&lt;/h2&gt;

&lt;p&gt;This is the most visible difference and has cascading implications for your stack.&lt;/p&gt;

&lt;h3&gt;
  
  
  shadcn/ui: Tailwind Utility Classes
&lt;/h3&gt;

&lt;p&gt;Components are styled with Tailwind utility classes and CSS custom properties for theming. Source code lives in your project, so you change any class directly.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="c1"&gt;// A shadcn/ui button, you own and can modify this code&lt;/span&gt;
&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;Button&lt;/span&gt; &lt;span class="n"&gt;variant&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"outline"&lt;/span&gt; &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"gap-2"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;PlusIcon&lt;/span&gt; &lt;span class="n"&gt;className&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"h-4 w-4"&lt;/span&gt; &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
  &lt;span class="nc"&gt;Add&lt;/span&gt; &lt;span class="n"&gt;member&lt;/span&gt;
&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;Button&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;No runtime style generation, no specificity battles, no hidden CSS layers. What you see in the markup is what renders.&lt;/p&gt;

&lt;h3&gt;
  
  
  Material UI: Emotion / CSS-in-JS
&lt;/h3&gt;

&lt;p&gt;MUI v9 uses Emotion as the default styling engine. Styles generate at runtime through the &lt;code&gt;sx&lt;/code&gt; prop, &lt;code&gt;styled()&lt;/code&gt; API, or the theme object.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="c1"&gt;// A Material UI button with sx prop styling&lt;/span&gt;
&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;Button&lt;/span&gt; &lt;span class="n"&gt;variant&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"outlined"&lt;/span&gt; &lt;span class="n"&gt;sx&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;gap&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;AddIcon&lt;/span&gt; &lt;span class="n"&gt;fontSize&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"small"&lt;/span&gt; &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;
  &lt;span class="nc"&gt;Add&lt;/span&gt; &lt;span class="n"&gt;member&lt;/span&gt;
&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;Button&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The theming system is powerful for global overrides, but introduces runtime overhead and a different mental model from utility-first CSS. Running Tailwind for custom code and Emotion for MUI components adds bundle size, cognitive load, and occasional specificity conflicts.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;For teams already invested in Tailwind&lt;/strong&gt;, shadcn/ui is the natural fit. For teams that prefer a self-contained design system and don't mind CSS-in-JS, MUI's theming layer is mature and well-documented.&lt;/p&gt;

&lt;h2&gt;
  
  
  Accessibility Comparison
&lt;/h2&gt;

&lt;p&gt;Both libraries take accessibility seriously but approach it differently.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;shadcn/ui&lt;/strong&gt; delegates to headless primitives (Radix UI by default, Base UI or React Aria as alternatives). Radix handles ARIA attributes, keyboard navigation, focus management, and screen reader announcements for complex components like dialogs, dropdowns, tabs, and tooltips. Accessibility behavior is built into the primitives, not bolted on. Components ship with solid WCAG AA foundations out of the box.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Material UI&lt;/strong&gt; provides strong accessibility defaults with ARIA attributes, keyboard handlers, and focus trapping. Each component's docs link to the matching WAI-ARIA pattern. However, accessibility depends partly on correct usage: you must pass &lt;code&gt;aria-label&lt;/code&gt; props explicitly in some cases, and certain customization patterns (overriding internal slots) can inadvertently break accessibility if you're not careful.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Bottom line&lt;/strong&gt;: Both are strong for accessible SaaS products. shadcn/ui's advantage is that Radix primitives enforce accessibility constraints at the structural level, making it harder to accidentally break things. MUI's advantage is maturity, its patterns are battle-tested across thousands of production applications.&lt;/p&gt;

&lt;h2&gt;
  
  
  Customization and Theming Flexibility
&lt;/h2&gt;

&lt;p&gt;This is where the libraries diverge most, and it's arguably the most important factor for SaaS products needing a distinct brand.&lt;/p&gt;

&lt;h3&gt;
  
  
  shadcn/ui: Full Source Ownership
&lt;/h3&gt;

&lt;p&gt;Because components live in your codebase, there are no customization boundaries. You can:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Change the markup structure of any component&lt;/li&gt;
&lt;li&gt;Choose Radix, Base UI, or React Aria as primitives, or swap later&lt;/li&gt;
&lt;li&gt;Add, remove, or rename props&lt;/li&gt;
&lt;li&gt;Modify animations, transitions, and responsive behavior&lt;/li&gt;
&lt;li&gt;Build your own design token system on top of CSS variables&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;No "ejecting" because you already own the code.&lt;/p&gt;

&lt;h3&gt;
  
  
  Material UI: Theme Object and Style Overrides
&lt;/h3&gt;

&lt;p&gt;Customization centers on a theme object defining colors, typography, spacing, breakpoints, and component-level overrides applied globally.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;theme&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;createTheme&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;palette&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="n"&gt;primary&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;main&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'#6366f1'&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;components&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nc"&gt;MuiButton&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;styleOverrides&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="n"&gt;root&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;textTransform&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'none'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;borderRadius&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'8px'&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Powerful for consistency but constraining when breaking from Material Design's visual language. If you need a fundamentally different DOM structure, sub-components, or interaction pattern, you'll often fight the library.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;For SaaS products&lt;/strong&gt;, the ability to build a distinct visual identity matters. Most successful SaaS products don't look like Material Design apps. shadcn/ui gives more room to define your own design language; MUI gives a polished starting point harder to stray from.&lt;/p&gt;

&lt;h2&gt;
  
  
  Bundle Size and Performance
&lt;/h2&gt;

&lt;h3&gt;
  
  
  shadcn/ui
&lt;/h3&gt;

&lt;p&gt;No runtime of its own. You ship only components you add (files in your project), and Tailwind generates CSS at build time. JavaScript cost is the headless primitives you use, small, focused packages.&lt;/p&gt;

&lt;h3&gt;
  
  
  Material UI
&lt;/h3&gt;

&lt;p&gt;Imports rely on tree-shaking. The bigger difference is the styling runtime: Emotion generates and injects styles in the browser, adding work at load and during hydration in server-rendered Next.js apps. Pigment CSS (zero-runtime alternative) is opt-in and pre-1.0 in September 2026.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;For performance-sensitive SaaS products&lt;/strong&gt;, shadcn/ui's build-time CSS usually means less JavaScript and no style runtime, which matters most on dashboards and in Next.js App Router projects with React Server Components. Measure your own app, the gap depends heavily on component count.&lt;/p&gt;

&lt;h2&gt;
  
  
  Component Quality and Completeness
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Material UI: The Completeness Advantage
&lt;/h3&gt;

&lt;p&gt;MUI's library is one of the most comprehensive available. Beyond standard components, MUI X adds:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Data Grid&lt;/strong&gt;: Full-featured table with sorting, filtering, pagination, virtualization&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Date and Time Pickers&lt;/strong&gt;: Comprehensive selection components&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Charts&lt;/strong&gt;: Dashboard charting components&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Scheduler&lt;/strong&gt;: Calendar and scheduling views&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Tree View, Transfer List, Masonry&lt;/strong&gt;: Specialized layout components&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Free MIT-licensed Community versions of Data Grid, Date Pickers, Charts, Tree View, and Scheduler go far. Advanced features need a commercial license: &lt;strong&gt;MUI X Pro is $299 per developer per year and Premium $599&lt;/strong&gt;. For enterprise SaaS needing complex data-heavy interfaces quickly, MUI's breadth is a genuine advantage.&lt;/p&gt;

&lt;h3&gt;
  
  
  shadcn/ui: Growing but Focused
&lt;/h3&gt;

&lt;p&gt;Covers core components well: buttons, inputs, dialogs, dropdowns, tabs, tables, forms, toasts, command palettes. Now includes chart components (Recharts-based), calendar and date picker, and a data table recipe using TanStack Table. No equivalent of MUI X Pro's advanced data grid (grouping, pivoting, Excel export).&lt;/p&gt;

&lt;p&gt;For gaps, teams reach for TanStack Table, AG Grid, or build custom implementations, more flexibility but more assembly.&lt;/p&gt;

&lt;h2&gt;
  
  
  When to Choose shadcn/ui
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;You use Tailwind CSS&lt;/strong&gt;. shadcn/ui is built for Tailwind-first projects. Next.js + Tailwind + TypeScript fits naturally with zero styling friction.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;You need a distinct brand&lt;/strong&gt;. SaaS products needing to look unique benefit from full source ownership and token-driven theming.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;You want full control&lt;/strong&gt;. Teams wanting to own their component layer, modify internals freely, and avoid third-party release cycles.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Performance is a priority&lt;/strong&gt;. Compile-time CSS and minimal runtime overhead.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;You're building on a design token system&lt;/strong&gt;. CSS variable architecture works naturally with design tokens.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Accessibility is non-negotiable&lt;/strong&gt;. Radix, Base UI, and React Aria are among the best headless accessibility foundations.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  When to Choose Material UI
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;You want Material Design&lt;/strong&gt;. MUI is the most complete implementation (Material Design 2, not 3).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;You need an advanced data grid&lt;/strong&gt;. MUI X's Data Grid Pro/Premium (grouping, aggregation, pivoting, export) are hard to match if the per-developer license fits.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;You're building enterprise internal tools&lt;/strong&gt;. For internal apps where brand differentiation isn't critical but speed is, MUI's opinionated defaults get you to a usable interface quickly.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Your team is already experienced with MUI&lt;/strong&gt;. Switching costs are real.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;You need rapid prototyping&lt;/strong&gt;. Complete design system with consistent spacing, typography, and color lets you prototype without design decisions at every step.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Quick Comparison
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Dimension&lt;/th&gt;
&lt;th&gt;shadcn/ui&lt;/th&gt;
&lt;th&gt;Material UI&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Styling&lt;/td&gt;
&lt;td&gt;Tailwind CSS (compile-time)&lt;/td&gt;
&lt;td&gt;Emotion / CSS-in-JS (runtime)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Ownership&lt;/td&gt;
&lt;td&gt;Source code in your project&lt;/td&gt;
&lt;td&gt;npm package dependency&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Design language&lt;/td&gt;
&lt;td&gt;Flexible, build your own&lt;/td&gt;
&lt;td&gt;Material Design (customizable)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Primitives / accessibility&lt;/td&gt;
&lt;td&gt;Radix, Base UI, or React Aria&lt;/td&gt;
&lt;td&gt;Built-in ARIA + keyboard&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Runtime styling cost&lt;/td&gt;
&lt;td&gt;None (build-time CSS)&lt;/td&gt;
&lt;td&gt;Emotion runtime by default&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Completeness&lt;/td&gt;
&lt;td&gt;Core + charts, date picker, data table recipe&lt;/td&gt;
&lt;td&gt;Extensive + MUI X (Pro $299, Premium $599/dev/year)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Current version&lt;/td&gt;
&lt;td&gt;CLI v4, Tailwind v4, React 19&lt;/td&gt;
&lt;td&gt;v9 (Material Design 2)&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  The Gotcha
&lt;/h2&gt;

&lt;p&gt;If you need MUI X's advanced data grid but want shadcn/ui for everything else, you can mix them, but you'll ship two styling systems (Tailwind and Emotion) and two design languages. A common compromise is shadcn/ui for the app and MUI X Data Grid only where advanced features are necessary.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;This is a shorter version of a guide I wrote at Frontkit Studio. The &lt;a href="https://thefrontkit.com/blogs/shadcn-ui-vs-material-ui-for-saas?utm_source=devto&amp;amp;utm_medium=syndication" rel="noopener noreferrer"&gt;full post&lt;/a&gt; has the complete walkthrough.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>nextjs</category>
      <category>react</category>
      <category>tailwindcss</category>
      <category>typescript</category>
    </item>
    <item>
      <title>Building a Production AI Chatbot in Next.js: Architecture and Pitfalls</title>
      <dc:creator>Gaurav Guha</dc:creator>
      <pubDate>Mon, 09 Nov 2026 13:36:13 +0000</pubDate>
      <link>https://dev.to/greedy_reader/building-a-production-ai-chatbot-in-nextjs-architecture-and-pitfalls-4e52</link>
      <guid>https://dev.to/greedy_reader/building-a-production-ai-chatbot-in-nextjs-architecture-and-pitfalls-4e52</guid>
      <description>&lt;p&gt;You have a working chat interface in an afternoon. Turning it into a product users pay for takes months. The gap isn't the model: it's conversation history, citations, cost guards, and the boring auth and billing layer nobody talks about.&lt;/p&gt;

&lt;h2&gt;
  
  
  What a Real Chatbot Product Has to Handle
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Streaming Chat UI
&lt;/h3&gt;

&lt;p&gt;Token-by-token rendering is the baseline. You need SSE or fetch streaming, Markdown rendering mid-stream with code blocks and syntax highlighting, a stop button, regenerate, edit-and-resend, and scroll-to-bottom that respects where the user scrolled. The Vercel AI SDK handles all of this. Don't roll streaming yourself.&lt;/p&gt;

&lt;h3&gt;
  
  
  Conversation History
&lt;/h3&gt;

&lt;p&gt;Not a single chat: a list of chats with a sidebar, new-chat button, rename and delete, folders or categories, search across conversations, pinning, and optional public sharing. Storage is a &lt;code&gt;conversations&lt;/code&gt; table with &lt;code&gt;messages&lt;/code&gt; linked by &lt;code&gt;conversation_id&lt;/code&gt;, indexed by user and updated-at.&lt;/p&gt;

&lt;h3&gt;
  
  
  Multi-Model Support
&lt;/h3&gt;

&lt;p&gt;Production chatbots route across OpenAI GPT-5 for reasoning, Anthropic Claude for long context, Gemini for multimodal, self-hosted Llama or Mistral for privacy, and fine-tunes for specific tasks. The UI should expose model selection or route automatically.&lt;/p&gt;

&lt;h3&gt;
  
  
  RAG (Retrieval-Augmented Generation)
&lt;/h3&gt;

&lt;p&gt;When the bot answers questions about your data:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Document ingestion for PDFs, web pages, uploads&lt;/li&gt;
&lt;li&gt;Semantic chunking beats fixed-size in 2026&lt;/li&gt;
&lt;li&gt;Embeddings via OpenAI text-embedding-3-large or Voyage AI&lt;/li&gt;
&lt;li&gt;Vector storage in pgvector, Pinecone, Qdrant, or Weaviate&lt;/li&gt;
&lt;li&gt;Hybrid retrieval (keyword + semantic) with reranking&lt;/li&gt;
&lt;li&gt;Citation rendering showing which sources the answer uses&lt;/li&gt;
&lt;li&gt;Clickable source previews&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Without RAG your bot is generic ChatGPT. With RAG it knows the customer's data.&lt;/p&gt;

&lt;h3&gt;
  
  
  Tool Calling
&lt;/h3&gt;

&lt;p&gt;Real agents take actions:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Function definitions in JSON schema&lt;/li&gt;
&lt;li&gt;Tool call rendering in chat ("Looking up order #1234...")&lt;/li&gt;
&lt;li&gt;Approval flows for destructive actions&lt;/li&gt;
&lt;li&gt;Multi-tool sequences where the model picks the right order&lt;/li&gt;
&lt;li&gt;Error handling when tools fail&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The Vercel AI SDK and OpenAI's tool calling API handle mechanics. Product work is choosing tools and UX patterns.&lt;/p&gt;

&lt;h3&gt;
  
  
  Citations and Source Attribution
&lt;/h3&gt;

&lt;p&gt;The trust layer:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Inline citations &lt;code&gt;[1] [2]&lt;/code&gt; clickable to sources&lt;/li&gt;
&lt;li&gt;Source list at bottom of each answer&lt;/li&gt;
&lt;li&gt;Source preview on hover showing content snippet&lt;/li&gt;
&lt;li&gt;Confidence indicators when unsure&lt;/li&gt;
&lt;li&gt;Refusal handling when data doesn't support an answer&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Without clickable citations users can't verify anything important.&lt;/p&gt;

&lt;h3&gt;
  
  
  Feedback Capture
&lt;/h3&gt;

&lt;p&gt;For improving the product:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Thumbs up/down per response&lt;/li&gt;
&lt;li&gt;Optional comment explaining the rating&lt;/li&gt;
&lt;li&gt;Inline issue tags ("inaccurate", "irrelevant", "harmful")&lt;/li&gt;
&lt;li&gt;Aggregation dashboard showing top issues&lt;/li&gt;
&lt;li&gt;Per-prompt feedback rollups to identify failing prompt patterns&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Rate Limiting and Cost Control
&lt;/h3&gt;

&lt;p&gt;Critical and often skipped:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Per-user rate limits (N messages per hour)&lt;/li&gt;
&lt;li&gt;Per-account quotas (M messages per month for free tier)&lt;/li&gt;
&lt;li&gt;Per-model cost tracking with daily/monthly caps&lt;/li&gt;
&lt;li&gt;Hard stop at cost threshold to prevent runaway bills&lt;/li&gt;
&lt;li&gt;Token usage dashboard for admins&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;A single bug or abusive user can run up a five-figure bill overnight. Build cost controls before launch.&lt;/p&gt;

&lt;h3&gt;
  
  
  Deployment and Auth
&lt;/h3&gt;

&lt;p&gt;The boring critical path:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Auth via Clerk, Auth.js, or Supabase Auth&lt;/li&gt;
&lt;li&gt;User accounts with conversation history per user&lt;/li&gt;
&lt;li&gt;Subscription tiers with rate limits per tier&lt;/li&gt;
&lt;li&gt;Onboarding flow so first-time users understand the bot&lt;/li&gt;
&lt;li&gt;Marketing site that drives signups&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;This is where most "ChatGPT for X" products fail: working chatbot, no auth, no billing, no real product around it.&lt;/p&gt;

&lt;h2&gt;
  
  
  Tech Stack Decisions
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Streaming framework:&lt;/strong&gt; Vercel AI SDK. Standard in 2026. Handles streaming, tool calls, structured outputs, multi-model.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Model APIs:&lt;/strong&gt; OpenAI SDK + Anthropic SDK, or AI SDK abstractions for one interface.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Vector database:&lt;/strong&gt; pgvector if Postgres-based (cheap, easy). Pinecone for managed. Qdrant for self-hosted.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Embeddings:&lt;/strong&gt; OpenAI text-embedding-3-large or Voyage AI voyage-3.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Real-time:&lt;/strong&gt; Built into streaming layer; no separate WebSocket needed.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;File parsing:&lt;/strong&gt; Unstructured.io or LlamaParse for PDF, DOCX.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Background jobs:&lt;/strong&gt; Inngest for async document ingestion.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Database:&lt;/strong&gt; Postgres + Drizzle. Conversations + messages tables.&lt;/p&gt;

&lt;h2&gt;
  
  
  Build Path 1: From Scratch (6 to 10 Weeks)
&lt;/h2&gt;

&lt;p&gt;Week 1-2: Foundation. Next.js, auth, basic chat UI with Vercel AI SDK, conversation history.&lt;/p&gt;

&lt;p&gt;Week 3-4: Multi-model + tool calling. Wire OpenAI + Anthropic. Build a few tools.&lt;/p&gt;

&lt;p&gt;Week 5-6: RAG if needed. Document ingestion, embedding, vector storage, retrieval, citations.&lt;/p&gt;

&lt;p&gt;Week 7-8: Cost controls and rate limiting. Per-user limits, per-account quotas, cost dashboard.&lt;/p&gt;

&lt;p&gt;Week 9-10: Polish and deployment. Auth tiers, marketing site, onboarding, Stripe wiring.&lt;/p&gt;

&lt;p&gt;Most teams take 10 to 14 weeks. RAG alone is routinely 3-4 weeks if done well.&lt;/p&gt;

&lt;h2&gt;
  
  
  Build Path 2: Fork a Starter, Buy the Interface (3 to 5 Weeks)
&lt;/h2&gt;

&lt;p&gt;Split the problem. Fork Vercel AI Chatbot or LibreChat for auth, conversation persistence, model routing, streaming plumbing. Both are open source and functional day one. What they don't give you is an interface anyone would pay for: that's where remaining weeks go.&lt;/p&gt;

&lt;p&gt;The work that remains:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Wire your model provider through Vercel AI SDK&lt;/li&gt;
&lt;li&gt;Build retrieval if you need RAG, typically pgvector&lt;/li&gt;
&lt;li&gt;Add rate limiting and per-user cost caps&lt;/li&gt;
&lt;li&gt;Connect Stripe if charging&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Common Pitfalls
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Rolling streaming yourself.&lt;/strong&gt; Use Vercel AI SDK. Edge cases (reconnection, partial messages, stream cancellation) are solved.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Single-model lock-in.&lt;/strong&gt; OpenAI pricing changes. Anthropic launches better models. Without an abstraction layer, switching is a refactor. Use provider-agnostic interface from day one.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;No cost controls.&lt;/strong&gt; A single bug or abusive user spends $10k overnight. Build per-user, per-account, and global daily cost caps before launch.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;RAG without reranking.&lt;/strong&gt; Top-K retrieval alone misses the right chunk often. Add reranking (Cohere Rerank, OpenAI rerank) for production quality.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Citations as decoration.&lt;/strong&gt; If citations aren't clickable to the source, users can't verify. Build source-preview UX from day one.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Storing prompts as code constants.&lt;/strong&gt; Prompts change weekly. Pull them into config or database so non-developers can iterate.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;No evals.&lt;/strong&gt; You change the prompt and have no way to know if quality went up or down. Build a basic eval suite (10-50 test cases) before the first prompt change.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Underbuilding the conversation sidebar.&lt;/strong&gt; Without history every chat starts cold. Users hate it. Build the sidebar in v1.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;This is a shorter version of a guide I wrote at Frontkit Studio. The &lt;a href="https://thefrontkit.com/blogs/how-to-build-an-ai-chatbot-in-nextjs-2026?utm_source=devto&amp;amp;utm_medium=syndication" rel="noopener noreferrer"&gt;full post&lt;/a&gt; has the complete walkthrough.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>nextjs</category>
      <category>react</category>
      <category>ai</category>
      <category>typescript</category>
    </item>
    <item>
      <title>WCAG 2.1 AA Checklist for React and Next.js Applications</title>
      <dc:creator>Gaurav Guha</dc:creator>
      <pubDate>Sun, 08 Nov 2026 13:35:46 +0000</pubDate>
      <link>https://dev.to/greedy_reader/wcag-21-aa-checklist-for-react-and-nextjs-applications-59c1</link>
      <guid>https://dev.to/greedy_reader/wcag-21-aa-checklist-for-react-and-nextjs-applications-59c1</guid>
      <description>&lt;h2&gt;
  
  
  The problem
&lt;/h2&gt;

&lt;p&gt;You need to ship a web app that meets WCAG 2.1 AA: the baseline most legal requirements and procurement processes reference: but the spec is dense and hard to map to actual component code. This checklist translates each criterion into patterns you can use during development, code review, and QA.&lt;/p&gt;

&lt;h2&gt;
  
  
  Principle 1: Perceivable
&lt;/h2&gt;

&lt;h3&gt;
  
  
  1.1 Text alternatives
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;1.1.1 Non-text content&lt;/strong&gt;: Every non-text element needs a text alternative serving the same purpose.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="c1"&gt;// Good: Meaningful alt text&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;img&lt;/span&gt; &lt;span class="na"&gt;src&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"/dashboard-chart.png"&lt;/span&gt; &lt;span class="na"&gt;alt&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Monthly revenue chart showing 23% growth from January to March 2026"&lt;/span&gt; &lt;span class="p"&gt;/&amp;gt;&lt;/span&gt;

&lt;span class="c1"&gt;// Good: Decorative image&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;img&lt;/span&gt; &lt;span class="na"&gt;src&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"/decorative-wave.svg"&lt;/span&gt; &lt;span class="na"&gt;alt&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;""&lt;/span&gt; &lt;span class="p"&gt;/&amp;gt;&lt;/span&gt;

&lt;span class="c1"&gt;// Good: Icon button with label&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;button&lt;/span&gt; &lt;span class="na"&gt;aria-label&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Close dialog"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;XIcon&lt;/span&gt; &lt;span class="na"&gt;aria-hidden&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"true"&lt;/span&gt; &lt;span class="p"&gt;/&amp;gt;&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;button&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Key points:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;All &lt;code&gt;&amp;lt;img&amp;gt;&lt;/code&gt; elements have meaningful &lt;code&gt;alt&lt;/code&gt; describing purpose, not appearance&lt;/li&gt;
&lt;li&gt;Decorative images use &lt;code&gt;alt=""&lt;/code&gt; so screen readers skip them&lt;/li&gt;
&lt;li&gt;Icon buttons need &lt;code&gt;aria-label&lt;/code&gt; or visually hidden text&lt;/li&gt;
&lt;li&gt;SVG icons used as content need &lt;code&gt;role="img"&lt;/code&gt; and &lt;code&gt;aria-label&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;Charts and data visualizations need text descriptions or accessible data tables&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  1.3 Adaptable
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;1.3.1 Info and relationships&lt;/strong&gt;: Structure conveyed visually must be conveyed programmatically.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="c1"&gt;// Good: Proper table structure&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;table&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;thead&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;tr&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;th&lt;/span&gt; &lt;span class="na"&gt;scope&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"col"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;Name&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;th&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;th&lt;/span&gt; &lt;span class="na"&gt;scope&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"col"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;Role&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;th&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;th&lt;/span&gt; &lt;span class="na"&gt;scope&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"col"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;Status&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;th&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;tr&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;thead&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;tbody&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;tr&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;td&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;Jane Smith&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;td&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;td&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;Admin&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;td&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;td&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;Active&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;td&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;tr&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;tbody&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;table&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Requirements:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Headings use proper &lt;code&gt;&amp;lt;h1&amp;gt;&lt;/code&gt; through &lt;code&gt;&amp;lt;h6&amp;gt;&lt;/code&gt; in logical order (no skipping levels)&lt;/li&gt;
&lt;li&gt;Lists use &lt;code&gt;&amp;lt;ul&amp;gt;&lt;/code&gt;, &lt;code&gt;&amp;lt;ol&amp;gt;&lt;/code&gt;, or &lt;code&gt;&amp;lt;dl&amp;gt;&lt;/code&gt;: not styled &lt;code&gt;&amp;lt;div&amp;gt;&lt;/code&gt;s&lt;/li&gt;
&lt;li&gt;Data tables use &lt;code&gt;&amp;lt;table&amp;gt;&lt;/code&gt;, &lt;code&gt;&amp;lt;thead&amp;gt;&lt;/code&gt;, &lt;code&gt;&amp;lt;th&amp;gt;&lt;/code&gt;, &lt;code&gt;&amp;lt;td&amp;gt;&lt;/code&gt; with &lt;code&gt;scope&lt;/code&gt; attributes&lt;/li&gt;
&lt;li&gt;Form inputs associate with labels via &lt;code&gt;&amp;lt;label htmlFor="id"&amp;gt;&lt;/code&gt; or &lt;code&gt;aria-labelledby&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;Related fields grouped with &lt;code&gt;&amp;lt;fieldset&amp;gt;&lt;/code&gt; and &lt;code&gt;&amp;lt;legend&amp;gt;&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;Landmarks: &lt;code&gt;&amp;lt;nav&amp;gt;&lt;/code&gt;, &lt;code&gt;&amp;lt;main&amp;gt;&lt;/code&gt;, &lt;code&gt;&amp;lt;aside&amp;gt;&lt;/code&gt;, &lt;code&gt;&amp;lt;header&amp;gt;&lt;/code&gt;, &lt;code&gt;&amp;lt;footer&amp;gt;&lt;/code&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;1.3.5 Identify input purpose&lt;/strong&gt;: Form inputs for personal data use appropriate &lt;code&gt;autocomplete&lt;/code&gt; attributes.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;input&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"email"&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"email"&lt;/span&gt; &lt;span class="na"&gt;autoComplete&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"email"&lt;/span&gt; &lt;span class="p"&gt;/&amp;gt;&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;input&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"text"&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"name"&lt;/span&gt; &lt;span class="na"&gt;autoComplete&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"name"&lt;/span&gt; &lt;span class="p"&gt;/&amp;gt;&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;input&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"tel"&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"phone"&lt;/span&gt; &lt;span class="na"&gt;autoComplete&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"tel"&lt;/span&gt; &lt;span class="p"&gt;/&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  1.4 Distinguishable
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;1.4.3 Contrast (minimum)&lt;/strong&gt;: The criterion most products fail.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Normal text (&amp;lt; 18pt / 24px): 4.5:1 contrast ratio&lt;/li&gt;
&lt;li&gt;Large text (18pt+ bold or 24px+ regular): 3:1&lt;/li&gt;
&lt;li&gt;Applies to both light and dark mode&lt;/li&gt;
&lt;li&gt;Placeholder text must meet contrast requirements&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Tools: Chrome DevTools (Inspect &amp;gt; computed styles &amp;gt; contrast ratio), axe browser extension, Stark plugin for Figma.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;1.4.4 Resize text&lt;/strong&gt;: Text resizes to 200% without loss of content or functionality.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Use relative units (&lt;code&gt;rem&lt;/code&gt;, &lt;code&gt;em&lt;/code&gt;, &lt;code&gt;%&lt;/code&gt;) instead of &lt;code&gt;px&lt;/code&gt; for font sizes&lt;/li&gt;
&lt;li&gt;Layouts must not break at 200% browser zoom&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;1.4.10 Reflow&lt;/strong&gt;: Content reflows at 320px viewport width (400% zoom on 1280px screen) without horizontal scrolling.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;1.4.11 Non-text contrast&lt;/strong&gt;: UI components (buttons, inputs, checkboxes, toggles) need 3:1 contrast against adjacent colors. Focus indicators, chart lines, and meaningful icons also need 3:1.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;1.4.13 Content on hover or focus&lt;/strong&gt;: Tooltips and popovers:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Dismissible with Escape key without moving pointer&lt;/li&gt;
&lt;li&gt;Hoverable without disappearing&lt;/li&gt;
&lt;li&gt;Stay visible until dismissed, focus moves, or trigger unhovered&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Principle 2: Operable
&lt;/h2&gt;

&lt;h3&gt;
  
  
  2.1 Keyboard accessible
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;2.1.1 Keyboard&lt;/strong&gt;: Every interactive element reachable and operable via keyboard (Tab, Enter, Space, Arrow keys, Escape). Custom components (dropdowns, modals, accordions, tabs) need appropriate keyboard handlers.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;2.1.2 No keyboard trap&lt;/strong&gt;: Focus can always move away using standard navigation. Modals trap focus when open but release on close.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="c1"&gt;// Good: Modal with focus trap that releases on close&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;Dialog&lt;/span&gt; &lt;span class="na"&gt;open&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;isOpen&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt; &lt;span class="na"&gt;onClose&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;setIsOpen&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="cm"&gt;/* Focus is trapped here while open */&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
  &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;DialogPanel&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;h2&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;Settings&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;h2&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;button&lt;/span&gt; &lt;span class="na"&gt;onClick&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;setIsOpen&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;Close&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;button&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;DialogPanel&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;Dialog&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  2.2 Enough time
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;2.2.2 Pause, stop, hide&lt;/strong&gt;: Moving, blinking, or auto-updating content can be paused, stopped, or hidden. Animations respect &lt;code&gt;prefers-reduced-motion&lt;/code&gt;.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight css"&gt;&lt;code&gt;&lt;span class="k"&gt;@media&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;prefers-reduced-motion&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;reduce&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="o"&gt;*,&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt;&lt;span class="nd"&gt;::before&lt;/span&gt;&lt;span class="o"&gt;,&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt;&lt;span class="nd"&gt;::after&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nl"&gt;animation-duration&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="m"&gt;0.01ms&lt;/span&gt; &lt;span class="cp"&gt;!important&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="nl"&gt;transition-duration&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="m"&gt;0.01ms&lt;/span&gt; &lt;span class="cp"&gt;!important&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  2.4 Navigable
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;2.4.1 Bypass blocks&lt;/strong&gt;: "Skip to main content" link as first focusable element. Landmark regions allow screen reader users to jump between sections.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="c1"&gt;// Skip link as first element in layout&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;a&lt;/span&gt; &lt;span class="na"&gt;href&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"#main-content"&lt;/span&gt; &lt;span class="na"&gt;className&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"sr-only focus:not-sr-only focus:absolute focus:top-4 focus:left-4 focus:z-50 focus:px-4 focus:py-2 focus:bg-white focus:text-black focus:rounded"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  Skip to main content
&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;a&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;2.4.3 Focus order&lt;/strong&gt;: Tab order follows logical sequence matching visual layout. Dynamically added content (modals, toasts, expanded sections) receives focus appropriately. No &lt;code&gt;tabindex&lt;/code&gt; values greater than 0.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;2.4.7 Focus visible&lt;/strong&gt;: All interactive elements have visible focus indicator when keyboard-navigated.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight css"&gt;&lt;code&gt;&lt;span class="c"&gt;/* Good: Clear, visible focus indicator */&lt;/span&gt;
&lt;span class="nd"&gt;:focus-visible&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nl"&gt;outline&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="m"&gt;2px&lt;/span&gt; &lt;span class="nb"&gt;solid&lt;/span&gt; &lt;span class="nx"&gt;#685FD4&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nl"&gt;outline-offset&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="m"&gt;2px&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  2.5 Input modalities
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;2.5.3 Label in name&lt;/strong&gt;: Visible text label of a component is included in its accessible name. A button saying "Submit" has an accessible name containing "Submit" (not "btn-action-01").&lt;/p&gt;

&lt;h2&gt;
  
  
  Principle 3: Understandable
&lt;/h2&gt;

&lt;h3&gt;
  
  
  3.1 Readable
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;3.1.1 Language of page&lt;/strong&gt;: &lt;code&gt;&amp;lt;html&amp;gt;&lt;/code&gt; element has correct &lt;code&gt;lang&lt;/code&gt; attribute.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;html&lt;/span&gt; &lt;span class="na"&gt;lang&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"en"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;3.1.2 Language of parts&lt;/strong&gt;: Content in different language wrapped with appropriate &lt;code&gt;lang&lt;/code&gt; attribute.&lt;/p&gt;

&lt;h3&gt;
  
  
  3.2 Predictable
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;3.2.3 Consistent navigation&lt;/strong&gt;: Navigation menus appear in same location and order across pages.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;3.2.4 Consistent identification&lt;/strong&gt;: Components with same function have same label across the app. "Save" button is always "Save," not sometimes "Submit" or "Confirm."&lt;/p&gt;

&lt;h3&gt;
  
  
  3.3 Input assistance
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;3.3.1 Error identification&lt;/strong&gt;: Form errors identified in text, not just color. Messages specify which field and what's wrong.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;3.3.3 Error suggestion&lt;/strong&gt;: When error detected and suggestions available, provide them. "Invalid email" suggests "Enter an email address like &lt;a href="mailto:name@example.com"&gt;name@example.com&lt;/a&gt;."&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;3.3.4 Error prevention (legal, financial, data)&lt;/strong&gt;: Submissions involving legal, financial, or data changes are reversible, verified, or confirmed.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="c1"&gt;// Good: Confirmation before destructive action&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;Dialog&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;DialogTitle&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;Delete account?&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;DialogTitle&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;DialogDescription&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
    This will permanently delete your account and all associated data. This action cannot be undone.
  &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;DialogDescription&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;button&lt;/span&gt; &lt;span class="na"&gt;onClick&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;onCancel&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;Cancel&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;button&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;button&lt;/span&gt; &lt;span class="na"&gt;onClick&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;onConfirm&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;Delete account&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;button&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;Dialog&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Principle 4: Robust
&lt;/h2&gt;

&lt;h3&gt;
  
  
  4.1 Compatible
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;4.1.2 Name, role, value&lt;/strong&gt;: All interactive components have accessible name, role, and state. Custom components use appropriate ARIA roles. State changes communicated via &lt;code&gt;aria-expanded&lt;/code&gt;, &lt;code&gt;aria-selected&lt;/code&gt;, &lt;code&gt;aria-checked&lt;/code&gt;, &lt;code&gt;aria-disabled&lt;/code&gt;.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="c1"&gt;// Good: Custom accordion with proper ARIA&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt; &lt;span class="na"&gt;role&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"region"&lt;/span&gt; &lt;span class="na"&gt;aria-labelledby&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"section-heading"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;button&lt;/span&gt;
    &lt;span class="na"&gt;aria-expanded&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;isOpen&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
    &lt;span class="na"&gt;aria-controls&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"section-content"&lt;/span&gt;
    &lt;span class="na"&gt;id&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"section-heading"&lt;/span&gt;
  &lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
    Account Settings
  &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;button&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt; &lt;span class="na"&gt;id&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"section-content"&lt;/span&gt; &lt;span class="na"&gt;role&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"region"&lt;/span&gt; &lt;span class="na"&gt;hidden&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;isOpen&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="cm"&gt;/* Settings content */&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
  &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;4.1.3 Status messages&lt;/strong&gt;: Status messages announced to screen readers without receiving focus. Use &lt;code&gt;role="status"&lt;/code&gt;, &lt;code&gt;role="alert"&lt;/code&gt;, or &lt;code&gt;aria-live="polite"&lt;/code&gt;.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="c1"&gt;// Good: Toast notification announced to screen readers&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt; &lt;span class="na"&gt;role&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"status"&lt;/span&gt; &lt;span class="na"&gt;aria-live&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"polite"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;savedSuccessfully&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;Settings saved successfully.&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;

&lt;span class="c1"&gt;// Good: Alert for errors&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt; &lt;span class="na"&gt;role&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"alert"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;error&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="s2"&gt;`Error: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;error&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Testing checklist
&lt;/h2&gt;

&lt;p&gt;Automated testing catches only ~30% of issues. Run this minimum routine:&lt;/p&gt;

&lt;h3&gt;
  
  
  Automated
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Run axe DevTools or Lighthouse accessibility audit on every page&lt;/li&gt;
&lt;li&gt;Add &lt;code&gt;eslint-plugin-jsx-a11y&lt;/code&gt; to ESLint config for build-time checks&lt;/li&gt;
&lt;li&gt;Include accessibility checks in CI pipeline&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Manual keyboard
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Navigate entire app using only Tab, Shift+Tab, Enter, Space, Arrow keys, Escape&lt;/li&gt;
&lt;li&gt;Complete every user flow without a mouse&lt;/li&gt;
&lt;li&gt;Verify focus indicators always visible during keyboard navigation&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Screen reader
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Test with VoiceOver (macOS) or NVDA (Windows) on main user flows&lt;/li&gt;
&lt;li&gt;Verify headings, landmarks, and form labels announced correctly&lt;/li&gt;
&lt;li&gt;Confirm dynamic content changes (loading states, errors, new items) announced&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Visual
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Test at 200% browser zoom&lt;/li&gt;
&lt;li&gt;Test at 320px viewport width&lt;/li&gt;
&lt;li&gt;Test with &lt;code&gt;prefers-reduced-motion: reduce&lt;/code&gt; enabled&lt;/li&gt;
&lt;li&gt;Test in both light and dark mode&lt;/li&gt;
&lt;li&gt;Use contrast checker on all text and interactive elements&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Component libraries that handle accessibility
&lt;/h2&gt;

&lt;p&gt;Building every pattern from scratch is error-prone. These libraries provide accessible primitives:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;shadcn/ui + Radix UI:&lt;/strong&gt; Unstyled, accessible primitives styled with Tailwind CSS&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Headless UI:&lt;/strong&gt; Accessible components from the Tailwind CSS team&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;React Aria (Adobe):&lt;/strong&gt; Low-level accessibility hooks for custom components&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Start with accessible primitives, then maintain compliance as you customize.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;This is a shorter version of a guide I wrote at Frontkit Studio. The &lt;a href="https://thefrontkit.com/blogs/wcag-aa-checklist-for-web-apps?utm_source=devto&amp;amp;utm_medium=syndication" rel="noopener noreferrer"&gt;full post&lt;/a&gt; has the complete walkthrough.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>a11y</category>
      <category>react</category>
      <category>nextjs</category>
      <category>wcag</category>
    </item>
    <item>
      <title>Session Management Patterns for AI Chat Applications</title>
      <dc:creator>Gaurav Guha</dc:creator>
      <pubDate>Sat, 07 Nov 2026 13:30:54 +0000</pubDate>
      <link>https://dev.to/greedy_reader/session-management-patterns-for-ai-chat-applications-39np</link>
      <guid>https://dev.to/greedy_reader/session-management-patterns-for-ai-chat-applications-39np</guid>
      <description>&lt;p&gt;AI chat apps look simple: a prompt box, a streaming response, maybe citations. Under the hood, session management gets messy fast. How do you persist history across refreshes? How much context do you send to the model? What happens when the network hiccups or the user switches devices?&lt;/p&gt;

&lt;h2&gt;
  
  
  What "session" actually means
&lt;/h2&gt;

&lt;p&gt;A session isn't just a request/response pair. It covers:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Conversation history: user and assistant messages across turns&lt;/li&gt;
&lt;li&gt;Context window: the subset of history you actually send to the model&lt;/li&gt;
&lt;li&gt;Metadata: user ID, model version, feature flags, experiments&lt;/li&gt;
&lt;li&gt;Persistence: how long sessions live, how they resume, where they're stored&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Your UI needs to render history efficiently, stream new messages, handle reconnects and errors, and stay keyboard- and screen-reader-friendly.&lt;/p&gt;

&lt;h2&gt;
  
  
  Core UI pattern: a session chat hook
&lt;/h2&gt;

&lt;p&gt;Centralizing message state, loading, errors, and basic persistence in a hook keeps components clean. Here's a simplified usage pattern:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;useSessionChat&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;@/app/recipes/session/chat/hooks/use-session-chat&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;PromptInput&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;@/components/ui/composites/prompt-input&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;ResponseViewer&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;@/components/ui/composites/response-viewer&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;SessionChatPage&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nx"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nx"&gt;isLoading&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nx"&gt;error&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nx"&gt;sendMessage&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nx"&gt;retryLastMessage&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;useSessionChat&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
    &lt;span class="na"&gt;sessionId&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;customer-support-session&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;})&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;handleSubmit&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kr"&gt;string&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nf"&gt;sendMessage&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;content&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;value&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;

  &lt;span class="k"&gt;return &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt; &lt;span class="na"&gt;className&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"flex flex-col h-screen"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt; &lt;span class="na"&gt;className&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"flex-1 overflow-auto p-6 space-y-4"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
          &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt; &lt;span class="na"&gt;key&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;id&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt; &lt;span class="na"&gt;className&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;role&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;user&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;text-right&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;text-left&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
            &lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;role&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;assistant&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
              &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;ResponseViewer&lt;/span&gt; &lt;span class="na"&gt;content&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;content&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt; &lt;span class="p"&gt;/&amp;gt;&lt;/span&gt;
            &lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
              &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt; &lt;span class="na"&gt;className&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"inline-block bg-primary-50 rounded-lg px-4 py-2"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
                &lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;content&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
              &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
            &lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
          &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;

        &lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;error&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
          &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt; &lt;span class="na"&gt;className&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"mt-4 p-3 rounded-md bg-red-50 text-sm text-red-800 flex items-center justify-between"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
            &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;span&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;error&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;span&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
            &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;button&lt;/span&gt;
              &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"button"&lt;/span&gt;
              &lt;span class="na"&gt;onClick&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;retryLastMessage&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
              &lt;span class="na"&gt;className&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"ml-4 text-xs underline"&lt;/span&gt;
            &lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
              Retry
            &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;button&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
          &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;

      &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt; &lt;span class="na"&gt;className&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"border-t p-4"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;PromptInput&lt;/span&gt;
          &lt;span class="na"&gt;onSubmit&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;handleSubmit&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
          &lt;span class="na"&gt;disabled&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;isLoading&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
          &lt;span class="na"&gt;actionButton&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"send"&lt;/span&gt;
        &lt;span class="p"&gt;/&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The heavy lifting: state management, pending states, basic retries: lives in the hook, not scattered across components.&lt;/p&gt;

&lt;h2&gt;
  
  
  Where to store session data
&lt;/h2&gt;

&lt;p&gt;Session data can live in three places, each with trade-offs:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;In-memory (React state):&lt;/strong&gt; fast, lost on refresh&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Local storage:&lt;/strong&gt; persists across reloads, single device only&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Backend storage:&lt;/strong&gt; durable and multi-device, requires APIs&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The hook stays agnostic about storage. Hydrating from local storage looks like this:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;sendMessage&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;hydrateFromHistory&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;useSessionChat&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="nx"&gt;sessionId&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;

&lt;span class="nx"&gt;React&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;useEffect&lt;/span&gt;&lt;span class="p"&gt;(()&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;saved&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;window&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;localStorage&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;getItem&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`chat:&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;sessionId&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;saved&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nf"&gt;hydrateFromHistory&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;parse&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;saved&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;},&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;sessionId&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;hydrateFromHistory&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt;

&lt;span class="nx"&gt;React&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;useEffect&lt;/span&gt;&lt;span class="p"&gt;(()&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nb"&gt;window&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;localStorage&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;setItem&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`chat:&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;sessionId&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;stringify&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;
&lt;span class="p"&gt;},&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;sessionId&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Now sessions survive a refresh without any UI changes.&lt;/p&gt;

&lt;h2&gt;
  
  
  Managing context windows
&lt;/h2&gt;

&lt;p&gt;LLM context windows force you to decide how much history to send each turn. Common strategies:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Last N turns:&lt;/strong&gt; send only the most recent messages (fast, simple)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Summarized history:&lt;/strong&gt; compress older messages into a running summary&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Segmented sessions:&lt;/strong&gt; split long conversations into chapters&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The UI should show the full history even if the model only sees part of it. A last-N strategy in your &lt;code&gt;sendMessage&lt;/code&gt; handler:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;buildModelPayload&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;ChatMessage&lt;/span&gt;&lt;span class="p"&gt;[])&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;MAX_TURNS&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;12&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;visibleHistory&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;slice&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="nx"&gt;MAX_TURNS&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;visibleHistory&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;m&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;({&lt;/span&gt;
    &lt;span class="na"&gt;role&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;m&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;role&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;content&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;m&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;content&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;}))&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The UI stays unchanged; only the payload builder shifts.&lt;/p&gt;

&lt;h2&gt;
  
  
  Handling errors and retries gracefully
&lt;/h2&gt;

&lt;p&gt;Network hiccups and model errors are inevitable. Bad UIs lose the user's message, show generic banners, and offer no retry path. Better pattern:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Preserve the user's message in history&lt;/li&gt;
&lt;li&gt;Show per-message error states&lt;/li&gt;
&lt;li&gt;Allow "Retry" on that specific message
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="c1"&gt;// inside message rendering&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;role&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;assistant&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;status&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;error&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
  &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;button&lt;/span&gt;
    &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"button"&lt;/span&gt;
    &lt;span class="na"&gt;onClick&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;retryMessage&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
    &lt;span class="na"&gt;className&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"mt-2 text-xs text-red-700 underline"&lt;/span&gt;
  &lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
    Retry this response
  &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;button&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
&lt;span class="p"&gt;)}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Accessibility in session UIs
&lt;/h2&gt;

&lt;p&gt;Session management isn't just data: it's how the experience feels. Screen readers should announce new messages progressively. Keyboard users need to jump to the latest message, re-open prompts, and interact with citations and feedback.&lt;/p&gt;

&lt;p&gt;Streaming components need proper &lt;code&gt;aria-live&lt;/code&gt; regions, focusable elements for citations and controls, and predictable tab order across messages and input.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;ResponseViewer&lt;/span&gt;
  &lt;span class="na"&gt;content&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;streamedContent&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
  &lt;span class="na"&gt;format&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"markdown"&lt;/span&gt;
  &lt;span class="na"&gt;showCitations&lt;/span&gt;
  &lt;span class="na"&gt;aria-live&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"polite"&lt;/span&gt;
  &lt;span class="na"&gt;aria-atomic&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;/&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;You don't have to become an ARIA expert to get a reasonable default.&lt;/p&gt;

&lt;h2&gt;
  
  
  Multi-session interfaces
&lt;/h2&gt;

&lt;p&gt;Many apps need multiple concurrent sessions: conversations per project, customer, or case. Pattern:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Left sidebar lists sessions&lt;/li&gt;
&lt;li&gt;Right panel shows active session chat&lt;/li&gt;
&lt;li&gt;Both wired to the same session hook with different &lt;code&gt;sessionId&lt;/code&gt;s
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;SessionsLayout&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="nx"&gt;sessionId&lt;/span&gt; &lt;span class="p"&gt;}:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nl"&gt;sessionId&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kr"&gt;string&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;sessions&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;useUserSessions&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="c1"&gt;// your data source&lt;/span&gt;

  &lt;span class="k"&gt;return &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt; &lt;span class="na"&gt;className&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"flex h-screen"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;aside&lt;/span&gt; &lt;span class="na"&gt;className&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"w-72 border-r bg-secondary-50"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="cm"&gt;/* session list */&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
        &lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;sessions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;session&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
          &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;button&lt;/span&gt;
            &lt;span class="na"&gt;key&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;session&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;id&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
            &lt;span class="na"&gt;className&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"w-full text-left px-4 py-2 hover:bg-secondary-100"&lt;/span&gt;
            &lt;span class="na"&gt;onClick&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;router&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`/sessions/&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;session&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;id&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
          &lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
            &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt; &lt;span class="na"&gt;className&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"text-sm font-medium"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;session&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;title&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
            &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt; &lt;span class="na"&gt;className&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"text-xs text-secondary-600"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
              Updated &lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;session&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;updatedAtRelative&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
            &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
          &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;button&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;aside&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;

      &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;main&lt;/span&gt; &lt;span class="na"&gt;className&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"flex-1"&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;SessionChatPage&lt;/span&gt; &lt;span class="na"&gt;key&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;sessionId&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt; &lt;span class="p"&gt;/&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;main&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;div&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The &lt;code&gt;key={sessionId}&lt;/code&gt; on &lt;code&gt;SessionChatPage&lt;/code&gt; forces a clean remount when switching sessions, avoiding stale state.&lt;/p&gt;

&lt;h2&gt;
  
  
  Session management checklist
&lt;/h2&gt;

&lt;p&gt;Before shipping, verify:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;History&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Users see past messages after refresh&lt;/li&gt;
&lt;li&gt;Old messages don't break layout on mobile&lt;/li&gt;
&lt;li&gt;Long histories still feel fast&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Clear strategy for what goes to the model&lt;/li&gt;
&lt;li&gt;Not spamming the entire history on every call&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Resilience&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Network errors preserve the user's message&lt;/li&gt;
&lt;li&gt;Users can retry specific messages&lt;/li&gt;
&lt;li&gt;Timeouts and exceptions show clear, actionable errors&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Accessibility&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;New messages announced to screen readers&lt;/li&gt;
&lt;li&gt;Keyboard users navigate messages and actions&lt;/li&gt;
&lt;li&gt;Focus doesn't jump unexpectedly during streaming&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Multi-session&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Sessions have stable IDs and URLs&lt;/li&gt;
&lt;li&gt;Switching sessions is fast and predictable&lt;/li&gt;
&lt;li&gt;Session titles or metadata make sense to users&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The last item is a common gotcha: if you derive session titles from the first user message, make sure that title updates when the message edits or deletes, or you'll show stale labels in the sidebar.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;This is a shorter version of a guide I wrote at Frontkit Studio. The &lt;a href="https://thefrontkit.com/blogs/session-management-in-ai-chat-applications?utm_source=devto&amp;amp;utm_medium=syndication" rel="noopener noreferrer"&gt;full post&lt;/a&gt; has the complete walkthrough.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>nextjs</category>
      <category>react</category>
      <category>typescript</category>
      <category>ai</category>
    </item>
    <item>
      <title>Deploy a Next.js Template to Vercel Without Breaking Production</title>
      <dc:creator>Gaurav Guha</dc:creator>
      <pubDate>Fri, 06 Nov 2026 13:31:12 +0000</pubDate>
      <link>https://dev.to/greedy_reader/deploy-a-nextjs-template-to-vercel-without-breaking-production-5cd1</link>
      <guid>https://dev.to/greedy_reader/deploy-a-nextjs-template-to-vercel-without-breaking-production-5cd1</guid>
      <description>&lt;p&gt;Your Next.js template works locally. Pushing it to Vercel breaks the build because your local &lt;code&gt;.env.local&lt;/code&gt; isn't uploaded and preview deploys hit production APIs.&lt;/p&gt;




&lt;h2&gt;
  
  
  Step 1: Push the Template to GitHub
&lt;/h2&gt;

&lt;p&gt;If you cloned a template locally:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git init
git add &lt;span class="nb"&gt;.&lt;/span&gt;
git commit &lt;span class="nt"&gt;-m&lt;/span&gt; &lt;span class="s2"&gt;"Initial commit"&lt;/span&gt;
gh repo create my-product &lt;span class="nt"&gt;--private&lt;/span&gt; &lt;span class="nt"&gt;--source&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nb"&gt;.&lt;/span&gt; &lt;span class="nt"&gt;--remote&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;origin &lt;span class="nt"&gt;--push&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Or create a repo in the GitHub UI and push. Most paid templates require keeping the source private per the license: check before pushing publicly.&lt;/p&gt;




&lt;h2&gt;
  
  
  Step 2: Import the Project to Vercel
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;Go to &lt;code&gt;vercel.com/new&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;Import your GitHub repository (grant Vercel access when prompted)&lt;/li&gt;
&lt;li&gt;Vercel auto-detects Next.js&lt;/li&gt;
&lt;li&gt;Click Deploy&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;The first deploy runs without env vars and usually fails. That's expected: set them in Step 4 and redeploy.&lt;/p&gt;




&lt;h2&gt;
  
  
  Step 3: Configure the Build
&lt;/h2&gt;

&lt;p&gt;Vercel auto-detects most configs, but verify:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Framework Preset:&lt;/strong&gt; Next.js&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Build Command:&lt;/strong&gt; &lt;code&gt;next build&lt;/code&gt; (or whatever &lt;code&gt;package.json&lt;/code&gt; says)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Output Directory:&lt;/strong&gt; &lt;code&gt;.next&lt;/code&gt; (handled automatically)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Install Command:&lt;/strong&gt; &lt;code&gt;npm install&lt;/code&gt; (or &lt;code&gt;pnpm install&lt;/code&gt;, &lt;code&gt;yarn install&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Root Directory:&lt;/strong&gt; path to your Next.js app if it's in a subfolder&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;For monorepos (Turborepo, etc.), set Root Directory to the Next.js app path (&lt;code&gt;apps/web&lt;/code&gt; or similar).&lt;/p&gt;




&lt;h2&gt;
  
  
  Step 4: Set Environment Variables
&lt;/h2&gt;

&lt;p&gt;This is where most first deploys fail. Your local &lt;code&gt;.env.local&lt;/code&gt; is not uploaded. Set variables in Project &amp;gt; Settings &amp;gt; Environment Variables:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight conf"&gt;&lt;code&gt;&lt;span class="n"&gt;NEXT_PUBLIC_SUPABASE_URL&lt;/span&gt;=&lt;span class="n"&gt;https&lt;/span&gt;://...
&lt;span class="n"&gt;NEXT_PUBLIC_SUPABASE_ANON_KEY&lt;/span&gt;=...
&lt;span class="n"&gt;SUPABASE_SERVICE_ROLE_KEY&lt;/span&gt;=...
&lt;span class="n"&gt;DATABASE_URL&lt;/span&gt;=...
&lt;span class="n"&gt;NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY&lt;/span&gt;=...
&lt;span class="n"&gt;CLERK_SECRET_KEY&lt;/span&gt;=...
&lt;span class="n"&gt;STRIPE_SECRET_KEY&lt;/span&gt;=...
&lt;span class="n"&gt;STRIPE_WEBHOOK_SECRET&lt;/span&gt;=...
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;For each variable, pick environments: Production, Preview, Development. Most secrets belong in all three with test/sandbox values for Preview and Development, live values for Production.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Mistake to avoid:&lt;/strong&gt; putting production Stripe keys in Preview. Every preview deploy would charge real cards. Always use test keys in Preview.&lt;/p&gt;




&lt;h2&gt;
  
  
  Step 5: Add a Custom Domain
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;Project &amp;gt; Settings &amp;gt; Domains&lt;/li&gt;
&lt;li&gt;Add your domain (e.g., &lt;code&gt;mysaas.com&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;Vercel gives you DNS records (usually A and CNAME)&lt;/li&gt;
&lt;li&gt;Add them at your registrar (Cloudflare, Namecheap, Porkbun, etc.)&lt;/li&gt;
&lt;li&gt;Wait for DNS propagation (usually under an hour, sometimes up to 48)&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Once verified, your domain serves the production deployment with an automatic SSL certificate.&lt;/p&gt;

&lt;p&gt;For www redirect: add both &lt;code&gt;mysaas.com&lt;/code&gt; and &lt;code&gt;www.mysaas.com&lt;/code&gt;, mark one as primary, and Vercel handles the redirect.&lt;/p&gt;




&lt;h2&gt;
  
  
  Step 6: Wire Up Preview Deployments
&lt;/h2&gt;

&lt;p&gt;Vercel automatically creates a preview deploy for every PR:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Builds the branch&lt;/li&gt;
&lt;li&gt;Deploys to a unique URL (&lt;code&gt;my-product-git-feature-abc.vercel.app&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;Posts the URL as a comment on the PR&lt;/li&gt;
&lt;li&gt;Updates on new commits&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;For these to work with auth and payments, Preview env vars must use test/sandbox credentials. Otherwise every PR preview hits production data.&lt;/p&gt;




&lt;h2&gt;
  
  
  Step 7: Set Up Cron Jobs
&lt;/h2&gt;

&lt;p&gt;Many SaaS apps need scheduled jobs. Vercel Cron handles this. Create &lt;code&gt;vercel.json&lt;/code&gt; in your project root:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"crons"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"path"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"/api/cron/publish-scheduled-posts"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"schedule"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"* * * * *"&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"path"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"/api/cron/send-digest"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"schedule"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"0 9 * * *"&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"path"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"/api/cron/sync-usage"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"schedule"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"0 */6 * * *"&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Each cron hits a GET endpoint on the schedule (standard cron syntax). Secure each endpoint:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// app/api/cron/publish-scheduled-posts/route.ts&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;NextRequest&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;NextResponse&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;next/server&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;GET&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;req&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;NextRequest&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;authHeader&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;req&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;authorization&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;authHeader&lt;/span&gt; &lt;span class="o"&gt;!==&lt;/span&gt; &lt;span class="s2"&gt;`Bearer &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;env&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;CRON_SECRET&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;NextResponse&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Unauthorized&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;status&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;401&lt;/span&gt; &lt;span class="p"&gt;});&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;

  &lt;span class="c1"&gt;// Do the scheduled work&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;posts&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;db&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;post&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;findMany&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
    &lt;span class="na"&gt;where&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;status&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;scheduled&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;publishAt&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;lte&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Date&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;});&lt;/span&gt;

  &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;post&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="nx"&gt;posts&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;db&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;post&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;update&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;where&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;post&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;id&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt; &lt;span class="na"&gt;data&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;status&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;published&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;});&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;

  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;NextResponse&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;OK&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Set &lt;code&gt;CRON_SECRET&lt;/code&gt; in env vars. Vercel automatically sends it in the &lt;code&gt;Authorization&lt;/code&gt; header.&lt;/p&gt;

&lt;p&gt;Free tier includes basic cron; high-frequency cron (every minute) requires Pro.&lt;/p&gt;




&lt;h2&gt;
  
  
  Step 8: Configure ISR (Incremental Static Regeneration)
&lt;/h2&gt;

&lt;p&gt;For pages that should cache but occasionally update (blog posts, product pages), use ISR:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;revalidate&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;60&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="c1"&gt;// re-generate this page every 60 seconds&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;BlogPost&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="nx"&gt;params&lt;/span&gt; &lt;span class="p"&gt;}:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nl"&gt;params&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;slug&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kr"&gt;string&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;post&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;db&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;post&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;findUnique&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;where&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;slug&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;params&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;slug&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;});&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nx"&gt;article&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;post&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;content&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="sr"&gt;/article&amp;gt;&lt;/span&gt;&lt;span class="err"&gt;;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The first request after &lt;code&gt;revalidate&lt;/code&gt; seconds gets new content (or regen happens in background). Other requests get the cached version.&lt;/p&gt;

&lt;p&gt;For on-demand revalidation (after publishing a post):&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;revalidatePath&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;next/cache&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="nf"&gt;revalidatePath&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`/blog/&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;slug&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This invalidates the cache for that path immediately. Combine with your publish flow so new posts appear instantly.&lt;/p&gt;




&lt;h2&gt;
  
  
  Step 9: Edge Config (for Feature Flags)
&lt;/h2&gt;

&lt;p&gt;For values that change frequently but should be globally available (feature flags, A/B test cohorts, kill switches), use Edge Config:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="kd"&gt;get&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;@vercel/edge-config&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;MyComponent&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;isFeatureEnabled&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;newDashboard&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;isFeatureEnabled&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nx"&gt;NewDashboard&lt;/span&gt; &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nx"&gt;OldDashboard&lt;/span&gt; &lt;span class="o"&gt;/&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Edge Config reads are &amp;lt;1ms globally. Writes are slow but rare. Perfect for kill switches and flags. Not necessary for v1 of most products: add when you need it.&lt;/p&gt;




&lt;h2&gt;
  
  
  Step 10: Monitor Performance
&lt;/h2&gt;

&lt;p&gt;Vercel Analytics tracks Core Web Vitals out of the box (Project &amp;gt; Analytics). Free tier includes basic stats; Pro has detailed segmentation.&lt;/p&gt;

&lt;p&gt;Pair with:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Sentry&lt;/strong&gt; for errors (frontend and API routes)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;PostHog&lt;/strong&gt; for product analytics&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Better Stack&lt;/strong&gt; for uptime alerting&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;These are third-party but Vercel has first-class integrations.&lt;/p&gt;




&lt;h2&gt;
  
  
  Common Gotchas
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Forgetting environment variables.&lt;/strong&gt; First deploy fails because &lt;code&gt;.env.local&lt;/code&gt; vars aren't on Vercel. Add them in Settings &amp;gt; Environment Variables.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Production keys in Preview.&lt;/strong&gt; Every PR preview charges real cards or hits production data. Use test/sandbox creds in Preview.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Image optimization not working.&lt;/strong&gt; Use &lt;code&gt;next/image&lt;/code&gt; and list external hosts in &lt;code&gt;next.config.js&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="nx"&gt;module&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;exports&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;images&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;remotePatterns&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[{&lt;/span&gt; &lt;span class="na"&gt;protocol&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;https&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;hostname&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;**&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="p"&gt;}]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;};&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Webhook URLs pointing to localhost.&lt;/strong&gt; Production webhooks (Stripe, Razorpay, Clerk) need your Vercel domain. Update URLs in each provider's dashboard when you deploy.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Cron not firing.&lt;/strong&gt; Check schedule syntax. &lt;code&gt;* * * * *&lt;/code&gt; is every minute; &lt;code&gt;0 9 * * *&lt;/code&gt; is 9 AM daily. Cron times are UTC. Verify in Vercel dashboard under Crons.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;API routes timing out.&lt;/strong&gt; Free tier has a 10-second timeout on serverless functions. Pro raises it to 60 seconds. For longer jobs, use background queues (Inngest, Trigger.dev) not API routes.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Massive serverless function size.&lt;/strong&gt; Too many imports in an API route exceeds Vercel's 50 MB unzipped limit. Deploy fails with size error. Fix: move heavy imports into separate files or use route segment config.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Cold starts on infrequent endpoints.&lt;/strong&gt; Serverless functions cold-start on first hit after idle. For latency-critical paths, use Edge functions or schedule a warmup cron.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;DNS propagation delays.&lt;/strong&gt; New domains can take up to 48 hours to fully propagate. Don't promise a launch time that depends on instant DNS.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Confusing Production and Preview.&lt;/strong&gt; Every push to main goes to Production. Every push to a feature branch goes to Preview. Don't push to main without verifying.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;This is a shorter version of a guide I wrote at Frontkit Studio. The &lt;a href="https://thefrontkit.com/blogs/deploy-nextjs-template-to-vercel-2026?utm_source=devto&amp;amp;utm_medium=syndication" rel="noopener noreferrer"&gt;full post&lt;/a&gt; has the complete walkthrough.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>nextjs</category>
      <category>vercel</category>
      <category>deployment</category>
      <category>typescript</category>
    </item>
    <item>
      <title>Form validation patterns that catch errors early and stay accessible</title>
      <dc:creator>Gaurav Guha</dc:creator>
      <pubDate>Thu, 05 Nov 2026 13:33:03 +0000</pubDate>
      <link>https://dev.to/greedy_reader/form-validation-patterns-that-catch-errors-early-and-stay-accessible-1aeb</link>
      <guid>https://dev.to/greedy_reader/form-validation-patterns-that-catch-errors-early-and-stay-accessible-1aeb</guid>
      <description>&lt;p&gt;Bad form validation feels like a wall: red text everywhere, fields resetting, cryptic errors, and no clear path to "fix it". Good validation feels like a guide, catching mistakes early, explaining clearly what's wrong, and supporting different input methods and devices.&lt;/p&gt;

&lt;h2&gt;
  
  
  Principles that keep validation predictable
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Catch errors early, not late:&lt;/strong&gt; Validate as users type or on blur, not only on submit.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Explain in plain language:&lt;/strong&gt; No jargon or backend error messages exposed.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Keep data safe:&lt;/strong&gt; Never clear fields on error.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Respect accessibility:&lt;/strong&gt; Screen readers and keyboard users should get the same guidance.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Be consistent:&lt;/strong&gt; Every form behaves the same way across your app.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Login form with inline validation
&lt;/h2&gt;

&lt;p&gt;This pattern uses react-hook-form with Zod, validating on blur so errors appear when the user leaves a field.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nx"&gt;React&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;react&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;useForm&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;react-hook-form&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;zodResolver&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;@hookform/resolvers/zod&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="kd"&gt;as &lt;/span&gt;&lt;span class="nx"&gt;z&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;zod&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;

&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nx"&gt;Form&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nx"&gt;FormField&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;@/components/ui/primitives/form&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nx"&gt;Field&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nx"&gt;FieldContent&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nx"&gt;FieldError&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;@/components/ui/primitives/field&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;Input&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;@/components/ui/primitives/input&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;Button&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;ButtonLabel&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;@/components/ui/primitives/button&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;loginSchema&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;z&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;object&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
  &lt;span class="na"&gt;email&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;z&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;string&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="nf"&gt;email&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;Please enter a valid email address&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt;
  &lt;span class="na"&gt;password&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;z&lt;/span&gt;
    &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;string&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;
    &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;min&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;6&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;Password must be at least 6 characters&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt;
&lt;span class="p"&gt;})&lt;/span&gt;

&lt;span class="kd"&gt;type&lt;/span&gt; &lt;span class="nx"&gt;LoginFormData&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;z&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;infer&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="k"&gt;typeof&lt;/span&gt; &lt;span class="nx"&gt;loginSchema&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;LoginForm&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="nx"&gt;onSubmit&lt;/span&gt; &lt;span class="p"&gt;}:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nl"&gt;onSubmit&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;LoginFormData&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nb"&gt;Promise&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="k"&gt;void&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nx"&gt;register&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nx"&gt;handleSubmit&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;formState&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;errors&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;isSubmitting&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;useForm&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nx"&gt;LoginFormData&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
    &lt;span class="na"&gt;resolver&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nf"&gt;zodResolver&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;loginSchema&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt;
    &lt;span class="na"&gt;mode&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;onBlur&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;})&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;handleFormSubmit&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;async &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;LoginFormData&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;onSubmit&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;

  &lt;span class="k"&gt;return &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;Form&lt;/span&gt; &lt;span class="na"&gt;onSubmit&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nf"&gt;handleSubmit&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;handleFormSubmit&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;FormField&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;Field&lt;/span&gt; &lt;span class="na"&gt;isInvalid&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="o"&gt;!!&lt;/span&gt;&lt;span class="nx"&gt;errors&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;email&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
          &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;FieldContent&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
            &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;Input&lt;/span&gt;
              &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"email"&lt;/span&gt;
              &lt;span class="na"&gt;placeholder&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Email"&lt;/span&gt;
              &lt;span class="na"&gt;isError&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="o"&gt;!!&lt;/span&gt;&lt;span class="nx"&gt;errors&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;email&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
              &lt;span class="na"&gt;isDisabled&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;isSubmitting&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
              &lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="p"&gt;...&lt;/span&gt;&lt;span class="nf"&gt;register&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;email&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
            &lt;span class="p"&gt;/&amp;gt;&lt;/span&gt;
            &lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;errors&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;email&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;FieldError&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;errors&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;email&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;FieldError&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
          &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;FieldContent&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;Field&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;FormField&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;

      &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;FormField&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;Field&lt;/span&gt; &lt;span class="na"&gt;isInvalid&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="o"&gt;!!&lt;/span&gt;&lt;span class="nx"&gt;errors&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;password&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
          &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;FieldContent&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
            &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;Input&lt;/span&gt;
              &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"password"&lt;/span&gt;
              &lt;span class="na"&gt;placeholder&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"Password"&lt;/span&gt;
              &lt;span class="na"&gt;isError&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="o"&gt;!!&lt;/span&gt;&lt;span class="nx"&gt;errors&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;password&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
              &lt;span class="na"&gt;isDisabled&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;isSubmitting&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
              &lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="p"&gt;...&lt;/span&gt;&lt;span class="nf"&gt;register&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;password&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
            &lt;span class="p"&gt;/&amp;gt;&lt;/span&gt;
            &lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;errors&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;password&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;FieldError&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;errors&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;password&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;FieldError&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
          &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;FieldContent&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;Field&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;FormField&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;

      &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;Button&lt;/span&gt;
        &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"submit"&lt;/span&gt;
        &lt;span class="na"&gt;action&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"primary"&lt;/span&gt;
        &lt;span class="na"&gt;className&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"w-full mt-4"&lt;/span&gt;
        &lt;span class="na"&gt;disabled&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;isSubmitting&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
      &lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
        &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;ButtonLabel&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;isSubmitting&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;Logging in...&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;Log in&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;ButtonLabel&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;Button&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;Form&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Why this works:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Errors attach to fields via &lt;code&gt;Field&lt;/code&gt; + &lt;code&gt;FieldError&lt;/code&gt;, not a generic banner.&lt;/li&gt;
&lt;li&gt;Clear copy ("Please enter a valid email address") instead of vague "Invalid input".&lt;/li&gt;
&lt;li&gt;Loading state (&lt;code&gt;isSubmitting&lt;/code&gt;) prevents double submits and disables inputs.&lt;/li&gt;
&lt;li&gt;Accessible markup: labels, error regions, and focus styles are handled by the primitives.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Inline errors plus error summary for longer forms
&lt;/h2&gt;

&lt;p&gt;Longer forms benefit from both inline errors under each field and an error summary at the top that links to the first problem.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;FormErrorSummary&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;@/components/ui/primitives/form&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;

&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;AccountSettingsForm&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nx"&gt;register&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nx"&gt;handleSubmit&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;formState&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;errors&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;useForm&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nx"&gt;AccountSettingsData&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
    &lt;span class="na"&gt;resolver&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nf"&gt;zodResolver&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;accountSettingsSchema&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt;
    &lt;span class="na"&gt;mode&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;onSubmit&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;})&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;onSubmit&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;async &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;AccountSettingsData&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="cm"&gt;/* ... */&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;

  &lt;span class="k"&gt;return &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;Form&lt;/span&gt; &lt;span class="na"&gt;onSubmit&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nf"&gt;handleSubmit&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;onSubmit&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;FormErrorSummary&lt;/span&gt; &lt;span class="na"&gt;errors&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;errors&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt; &lt;span class="p"&gt;/&amp;gt;&lt;/span&gt;
      &lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="cm"&gt;/* fields go here, using Field + FieldError like in LoginForm */&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;Form&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The error summary component maps over the error object and renders links that focus the corresponding field when clicked.&lt;/p&gt;

&lt;h2&gt;
  
  
  AI-specific validation: prompts, files, and feedback
&lt;/h2&gt;

&lt;p&gt;AI products introduce form-like interactions that go beyond traditional forms: prompt textareas, file uploads, feedback modals.&lt;/p&gt;

&lt;h3&gt;
  
  
  Prompt input with safe submission
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nx"&gt;PromptInput&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="kd"&gt;type&lt;/span&gt; &lt;span class="nx"&gt;AttachedFile&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;@/components/ui/composites/prompt-input&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;

&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;PromptSection&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;setPrompt&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;React&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;useState&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;""&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;files&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;setFiles&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;React&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;useState&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nx"&gt;AttachedFile&lt;/span&gt;&lt;span class="p"&gt;[]&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;([])&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;handleSubmit&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kr"&gt;string&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;attachedFiles&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;AttachedFile&lt;/span&gt;&lt;span class="p"&gt;[])&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;trim&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nx"&gt;attachedFiles&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="k"&gt;return&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="nf"&gt;sendToAI&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;attachedFiles&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;

  &lt;span class="k"&gt;return &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;PromptInput&lt;/span&gt;
      &lt;span class="na"&gt;value&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;prompt&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
      &lt;span class="na"&gt;onChange&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;setPrompt&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
      &lt;span class="na"&gt;onSubmit&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;handleSubmit&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
      &lt;span class="na"&gt;attachedFiles&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;files&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
      &lt;span class="na"&gt;onFileAttach&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;newFiles&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;safeFiles&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;normalizeFiles&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;newFiles&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="nf"&gt;setFiles&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;prev&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;[...&lt;/span&gt;&lt;span class="nx"&gt;prev&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;...&lt;/span&gt;&lt;span class="nx"&gt;safeFiles&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt;
      &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
      &lt;span class="na"&gt;maxFiles&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="mi"&gt;5&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
      &lt;span class="na"&gt;acceptedFileTypes&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;".pdf,.docx,.png,.jpg"&lt;/span&gt;
      &lt;span class="na"&gt;actionButton&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"send"&lt;/span&gt;
    &lt;span class="p"&gt;/&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This pattern:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Prevents empty submissions (no prompt, no file).&lt;/li&gt;
&lt;li&gt;Centralizes file validation logic in &lt;code&gt;normalizeFiles&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Uses one component for keyboard, screen reader, and pointer use.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Feedback modal with required rating
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;FeedbackModal&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;@/components/ui/templates/modal/feedback-modal&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;

&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;ResponseFeedback&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="nx"&gt;responseId&lt;/span&gt; &lt;span class="p"&gt;}:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nl"&gt;responseId&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kr"&gt;string&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;open&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;setOpen&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;React&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;useState&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;handleSubmit&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;async &lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="nx"&gt;rating&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;feedback&lt;/span&gt; &lt;span class="p"&gt;}:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nl"&gt;rating&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kr"&gt;number&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nl"&gt;feedback&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kr"&gt;string&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;rating&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="k"&gt;return&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;submitFeedback&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="nx"&gt;responseId&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;rating&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;feedback&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;
    &lt;span class="nf"&gt;setOpen&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;

  &lt;span class="k"&gt;return &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;button&lt;/span&gt;
        &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"button"&lt;/span&gt;
        &lt;span class="na"&gt;onClick&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;setOpen&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
        &lt;span class="na"&gt;className&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"text-xs text-secondary-600 hover:text-primary-600"&lt;/span&gt;
      &lt;span class="p"&gt;&amp;gt;&lt;/span&gt;
        Rate this response
      &lt;span class="p"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nt"&gt;button&lt;/span&gt;&lt;span class="p"&gt;&amp;gt;&lt;/span&gt;

      &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;FeedbackModal&lt;/span&gt;
        &lt;span class="na"&gt;isOpen&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;open&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
        &lt;span class="na"&gt;onClose&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;setOpen&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
        &lt;span class="na"&gt;onSubmit&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;handleSubmit&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
      &lt;span class="p"&gt;/&amp;gt;&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;/&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The guard &lt;code&gt;if (rating === 0)&lt;/code&gt; prevents submission without a selection. The modal handles focus trapping and announces errors to screen readers.&lt;/p&gt;

&lt;h2&gt;
  
  
  Validation checklist
&lt;/h2&gt;

&lt;p&gt;Use this when designing or reviewing forms:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Clarity&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Error messages use human language.&lt;/li&gt;
&lt;li&gt;Errors are placed directly next to fields.&lt;/li&gt;
&lt;li&gt;Field labels and help text explain what's expected.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Behavior&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Fields never clear themselves on validation error.&lt;/li&gt;
&lt;li&gt;Validation runs on blur and submit (not on every keystroke).&lt;/li&gt;
&lt;li&gt;Submit button shows a clear loading state during requests.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Accessibility&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Screen readers announce errors and which field they belong to.&lt;/li&gt;
&lt;li&gt;Error summary (for long forms) links to the first error.&lt;/li&gt;
&lt;li&gt;Focus moves logically and is never trapped.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Consistency&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;All forms reuse the same primitives (field, label, error).&lt;/li&gt;
&lt;li&gt;Validation rules are shared where possible (Zod schemas, etc.).&lt;/li&gt;
&lt;li&gt;Error colors and icons use the same tokens across the app.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Gotcha: validate on blur, not on change
&lt;/h2&gt;

&lt;p&gt;Running validation on every keystroke (&lt;code&gt;mode: "onChange"&lt;/code&gt;) floods the user with errors before they finish typing. &lt;code&gt;mode: "onBlur"&lt;/code&gt; waits until the field loses focus, which matches how people naturally fill forms. Reserve &lt;code&gt;mode: "onSubmit"&lt;/code&gt; for short forms where early feedback isn't needed.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;This is a shorter version of a guide I wrote at Frontkit Studio. The &lt;a href="https://thefrontkit.com/blogs/form-validation-patterns-that-dont-frustrate-users?utm_source=devto&amp;amp;utm_medium=syndication" rel="noopener noreferrer"&gt;full post&lt;/a&gt; has the complete walkthrough.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>react</category>
      <category>nextjs</category>
      <category>typescript</category>
      <category>a11y</category>
    </item>
  </channel>
</rss>
