feat: improve tag organization UX in cookbook forms

Reorganized cookbook creation and editing forms with clearer visual hierarchy and better explanations of how different tag types work together.

Changes:
- Add CSS for visual sections with borders, icons, and headers
- Reorganize form into 3 clear sections:
  1. Basic Information (name, description, cover image)
  2. Organize This Cookbook (cookbook tags)
  3. Auto-Add Content (collapsible, recipe tags + cookbook tags filters)
- Add icons for visual cues (📝 📋 ⚡ 🍲 📚)
- Improve labels and help text with concrete examples
- Make auto-add section collapsible (defaults to collapsed)
- Add subsections for recipe vs cookbook tag filters
- Better explain the relationship between different tag types

This change significantly improves the user experience by:
- Reducing confusion about tag types
- Showing clear visual hierarchy
- Providing contextual help and examples
- Making advanced features optional and collapsible

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

packages/web/src/pages/Cookbooks.tsx

@@ -20,6 +20,7 @@ function Cookbooks() {
   const [cookbookTagInput, setCookbookTagInput] = useState('');
   const [cookbookTagFilterInput, setCookbookTagFilterInput] = useState('');
   const [availableTags, setAvailableTags] = useState<Tag[]>([]);
+  const [autoAddCollapsed, setAutoAddCollapsed] = useState(true);
 
   useEffect(() => {
     loadData();
@@ -244,6 +245,16 @@ function Cookbooks() {
           <div className="modal" onClick={(e) => e.stopPropagation()}>
             <h2>Create New Cookbook</h2>
             <form onSubmit={handleCreateCookbook}>
+              {/* SECTION 1: BASIC INFO */}
+              <div className="form-section">
+                <div className="form-section-header">
+                  <span className="form-section-icon">📝</span>
+                  <div className="form-section-title">
+                    <h2>Basic Information</h2>
+                    <p>Give your cookbook a name and description</p>
+                  </div>
+                </div>
+                <div className="form-section-content">
                   <div className="form-group">
                     <label htmlFor="cookbook-name">Name *</label>
                     <input
@@ -265,39 +276,22 @@ function Cookbooks() {
                       rows={3}
                     />
                   </div>
-
-              <div className="form-group">
-                <label>Auto-Add Tags (Optional)</label>
-                <p className="help-text">Recipes with these tags will be automatically added to this cookbook</p>
-                <div className="filter-chips">
-                  {autoFilterTags.map(tag => (
-                    <span key={tag} className="filter-chip">
-                      {tag}
-                      <button type="button" onClick={() => handleRemoveTag(tag)}>×</button>
-                    </span>
-                  ))}
                 </div>
-                <div className="input-with-button">
-                  <input
-                    type="text"
-                    value={tagInput}
-                    onChange={(e) => setTagInput(e.target.value)}
-                    onKeyDown={(e) => e.key === 'Enter' && (e.preventDefault(), handleAddTag())}
-                    placeholder="Add tag"
-                    list="available-tags-modal"
-                  />
-                  <button type="button" onClick={handleAddTag} className="btn-add-filter">+</button>
-                </div>
-                <datalist id="available-tags-modal">
-                  {availableTags.map(tag => (
-                    <option key={tag.id} value={tag.name} />
-                  ))}
-                </datalist>
               </div>
 
+              {/* SECTION 2: ORGANIZE THIS COOKBOOK */}
+              <div className="form-section">
+                <div className="form-section-header">
+                  <span className="form-section-icon">📋</span>
+                  <div className="form-section-title">
+                    <h2>Organize This Cookbook</h2>
+                    <p>Tag this cookbook so you can find it later</p>
+                  </div>
+                </div>
+                <div className="form-section-content">
                   <div className="form-group">
-                <label>Cookbook Tags (Optional)</label>
-                <p className="help-text">Tags to categorize this cookbook (e.g., "holiday", "quick-meals")</p>
+                    <label>Cookbook Tags</label>
+                    <p className="help-text">Examples: "holiday", "meal-prep", "family-favorites"</p>
                     <div className="filter-chips">
                       {cookbookTags.map(tag => (
                         <span key={tag} className="filter-chip">
@@ -312,7 +306,7 @@ function Cookbooks() {
                         value={cookbookTagInput}
                         onChange={(e) => setCookbookTagInput(e.target.value)}
                         onKeyDown={(e) => e.key === 'Enter' && (e.preventDefault(), handleAddCookbookTag())}
-                    placeholder="Add tag"
+                        placeholder="Add a tag"
                         list="available-cookbook-tags"
                       />
                       <button type="button" onClick={handleAddCookbookTag} className="btn-add-filter">+</button>
@@ -323,10 +317,60 @@ function Cookbooks() {
                       ))}
                     </datalist>
                   </div>
+                </div>
+              </div>
 
-              <div className="form-group">
-                <label>Auto-Include Cookbooks by Tags (Optional)</label>
-                <p className="help-text">Other cookbooks with these tags will be automatically included</p>
+              {/* SECTION 3: AUTO-ADD CONTENT (COLLAPSIBLE) */}
+              <div className={`form-section collapsible ${autoAddCollapsed ? 'collapsed' : ''}`}>
+                <div className="form-section-header" onClick={() => setAutoAddCollapsed(!autoAddCollapsed)}>
+                  <span className="form-section-icon">⚡</span>
+                  <div className="form-section-title">
+                    <h2>Auto-Add Content (Optional)</h2>
+                    <p>Automatically add recipes and cookbooks</p>
+                  </div>
+                  <span className="form-section-toggle">▼</span>
+                </div>
+                <div className="form-section-content">
+                  {/* Subsection: By Recipe Tags */}
+                  <div className="form-subsection">
+                    <div className="form-subsection-header">
+                      <span className="form-subsection-icon">🍲</span>
+                      <h3>By Recipe Tags</h3>
+                    </div>
+                    <p className="help-text">Recipes tagged with these will be auto-added. Example: "vegetarian"</p>
+                    <div className="filter-chips">
+                      {autoFilterTags.map(tag => (
+                        <span key={tag} className="filter-chip">
+                          {tag}
+                          <button type="button" onClick={() => handleRemoveTag(tag)}>×</button>
+                        </span>
+                      ))}
+                    </div>
+                    <div className="input-with-button">
+                      <input
+                        type="text"
+                        value={tagInput}
+                        onChange={(e) => setTagInput(e.target.value)}
+                        onKeyDown={(e) => e.key === 'Enter' && (e.preventDefault(), handleAddTag())}
+                        placeholder="Add a tag"
+                        list="available-tags-modal"
+                      />
+                      <button type="button" onClick={handleAddTag} className="btn-add-filter">+</button>
+                    </div>
+                    <datalist id="available-tags-modal">
+                      {availableTags.map(tag => (
+                        <option key={tag.id} value={tag.name} />
+                      ))}
+                    </datalist>
+                  </div>
+
+                  {/* Subsection: By Cookbook Tags */}
+                  <div className="form-subsection">
+                    <div className="form-subsection-header">
+                      <span className="form-subsection-icon">📚</span>
+                      <h3>By Cookbook Tags</h3>
+                    </div>
+                    <p className="help-text">Include cookbooks tagged with these. Example: "italian"</p>
                     <div className="filter-chips">
                       {autoFilterCookbookTags.map(tag => (
                         <span key={tag} className="filter-chip">
@@ -341,7 +385,7 @@ function Cookbooks() {
                         value={cookbookTagFilterInput}
                         onChange={(e) => setCookbookTagFilterInput(e.target.value)}
                         onKeyDown={(e) => e.key === 'Enter' && (e.preventDefault(), handleAddCookbookTagFilter())}
-                    placeholder="Add tag to filter by"
+                        placeholder="Add a tag"
                         list="available-cookbook-filter-tags"
                       />
                       <button type="button" onClick={handleAddCookbookTagFilter} className="btn-add-filter">+</button>
@@ -352,6 +396,8 @@ function Cookbooks() {
                       ))}
                     </datalist>
                   </div>
+                </div>
+              </div>
 
               <div className="modal-actions">
                 <button type="button" onClick={() => setShowCreateModal(false)} className="btn-secondary">

packages/web/src/pages/EditCookbook.tsx

@@ -26,6 +26,7 @@ function EditCookbook() {
   const [cookbookTagInput, setCookbookTagInput] = useState('');
   const [cookbookTagFilterInput, setCookbookTagFilterInput] = useState('');
   const [availableTags, setAvailableTags] = useState<Tag[]>([]);
+  const [autoAddCollapsed, setAutoAddCollapsed] = useState(true);
 
   useEffect(() => {
     if (id) {
@@ -198,6 +199,16 @@ function EditCookbook() {
       </header>
 
       <form onSubmit={handleSubmit} className="edit-cookbook-form">
+        {/* SECTION 1: BASIC INFO */}
+        <div className="form-section">
+          <div className="form-section-header">
+            <span className="form-section-icon">📝</span>
+            <div className="form-section-title">
+              <h2>Basic Information</h2>
+              <p>Give your cookbook a name and description</p>
+            </div>
+          </div>
+          <div className="form-section-content">
             <div className="form-group">
               <label htmlFor="cookbook-name">Name *</label>
               <input
@@ -309,44 +320,22 @@ function EditCookbook() {
             </div>
           </div>
         </div>
-
-        <div className="form-group">
-          <label>Auto-Add Tags</label>
-          <p className="help-text">
-            Recipes with these tags will be automatically added to this cookbook
-          </p>
-          <div className="filter-chips">
-            {autoFilterTags.map(tag => (
-              <span key={tag} className="filter-chip">
-                {tag}
-                <button type="button" onClick={() => handleRemoveTag(tag)}>×</button>
-              </span>
-            ))}
-          </div>
-          <div className="input-with-button">
-            <input
-              type="text"
-              value={tagInput}
-              onChange={(e) => setTagInput(e.target.value)}
-              onKeyDown={(e) => e.key === 'Enter' && (e.preventDefault(), handleAddTag())}
-              placeholder="Add tag"
-              list="available-tags-edit"
-            />
-            <button type="button" onClick={handleAddTag} className="btn-add-filter">
-              +
-            </button>
-          </div>
-          <datalist id="available-tags-edit">
-            {availableTags.map(tag => (
-              <option key={tag.id} value={tag.name} />
-            ))}
-          </datalist>
         </div>
 
+        {/* SECTION 2: ORGANIZE THIS COOKBOOK */}
+        <div className="form-section">
+          <div className="form-section-header">
+            <span className="form-section-icon">📋</span>
+            <div className="form-section-title">
+              <h2>Organize This Cookbook</h2>
+              <p>Tag this cookbook so you can find it later and include it in other cookbooks</p>
+            </div>
+          </div>
+          <div className="form-section-content">
             <div className="form-group">
               <label>Cookbook Tags</label>
               <p className="help-text">
-            Tags to categorize this cookbook (e.g., "holiday", "quick-meals", "vegetarian")
+                Examples: "holiday", "meal-prep", "family-favorites", "quick-meals"
               </p>
               <div className="filter-chips">
                 {cookbookTags.map(tag => (
@@ -362,7 +351,7 @@ function EditCookbook() {
                   value={cookbookTagInput}
                   onChange={(e) => setCookbookTagInput(e.target.value)}
                   onKeyDown={(e) => e.key === 'Enter' && (e.preventDefault(), handleAddCookbookTag())}
-              placeholder="Add tag"
+                  placeholder="Add a tag"
                   list="available-cookbook-tags-edit"
                 />
                 <button type="button" onClick={handleAddCookbookTag} className="btn-add-filter">
@@ -375,11 +364,66 @@ function EditCookbook() {
                 ))}
               </datalist>
             </div>
+          </div>
+        </div>
 
-        <div className="form-group">
-          <label>Auto-Include Cookbooks by Tags</label>
+        {/* SECTION 3: AUTO-ADD CONTENT (COLLAPSIBLE) */}
+        <div className={`form-section collapsible ${autoAddCollapsed ? 'collapsed' : ''}`}>
+          <div className="form-section-header" onClick={() => setAutoAddCollapsed(!autoAddCollapsed)}>
+            <span className="form-section-icon">⚡</span>
+            <div className="form-section-title">
+              <h2>Auto-Add Content (Optional)</h2>
+              <p>Automatically add recipes and cookbooks matching these criteria</p>
+            </div>
+            <span className="form-section-toggle">▼</span>
+          </div>
+          <div className="form-section-content">
+            {/* Subsection: By Recipe Tags */}
+            <div className="form-subsection">
+              <div className="form-subsection-header">
+                <span className="form-subsection-icon">🍲</span>
+                <h3>By Recipe Tags</h3>
+              </div>
               <p className="help-text">
-            Other cookbooks with these tags will be automatically included in this cookbook
+                Recipes tagged with any of these will be automatically added to this cookbook.
+                Example: Add "vegetarian" to auto-include all vegetarian recipes.
+              </p>
+              <div className="filter-chips">
+                {autoFilterTags.map(tag => (
+                  <span key={tag} className="filter-chip">
+                    {tag}
+                    <button type="button" onClick={() => handleRemoveTag(tag)}>×</button>
+                  </span>
+                ))}
+              </div>
+              <div className="input-with-button">
+                <input
+                  type="text"
+                  value={tagInput}
+                  onChange={(e) => setTagInput(e.target.value)}
+                  onKeyDown={(e) => e.key === 'Enter' && (e.preventDefault(), handleAddTag())}
+                  placeholder="Add a tag"
+                  list="available-tags-edit"
+                />
+                <button type="button" onClick={handleAddTag} className="btn-add-filter">
+                  +
+                </button>
+              </div>
+              <datalist id="available-tags-edit">
+                {availableTags.map(tag => (
+                  <option key={tag.id} value={tag.name} />
+                ))}
+              </datalist>
+            </div>
+
+            {/* Subsection: By Cookbook Tags */}
+            <div className="form-subsection">
+              <div className="form-subsection-header">
+                <span className="form-subsection-icon">📚</span>
+                <h3>By Cookbook Tags</h3>
+              </div>
+              <p className="help-text">
+                Include other cookbooks tagged with these. Example: Add "italian" to include all Italian-themed cookbooks.
               </p>
               <div className="filter-chips">
                 {autoFilterCookbookTags.map(tag => (
@@ -395,7 +439,7 @@ function EditCookbook() {
                   value={cookbookTagFilterInput}
                   onChange={(e) => setCookbookTagFilterInput(e.target.value)}
                   onKeyDown={(e) => e.key === 'Enter' && (e.preventDefault(), handleAddCookbookTagFilter())}
-              placeholder="Add tag to filter by"
+                  placeholder="Add a tag"
                   list="available-cookbook-filter-tags-edit"
                 />
                 <button type="button" onClick={handleAddCookbookTagFilter} className="btn-add-filter">
@@ -408,6 +452,8 @@ function EditCookbook() {
                 ))}
               </datalist>
             </div>
+          </div>
+        </div>
 
         <div className="form-actions">
           <button type="button" onClick={() => navigate(`/cookbooks/${id}`)} className="btn-secondary">

packages/web/src/styles/Cookbooks.css

@@ -324,6 +324,111 @@
   font-weight: normal;
 }
 
+/* Form Sections with Visual Hierarchy */
+.form-section {
+  background: #fafafa;
+  border: 2px solid #e0e0e0;
+  border-radius: 12px;
+  padding: 1.5rem;
+  margin-bottom: 1.5rem;
+}
+
+.form-section-header {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  margin-bottom: 1rem;
+  padding-bottom: 0.75rem;
+  border-bottom: 2px solid #e0e0e0;
+}
+
+.form-section-icon {
+  font-size: 1.5rem;
+  line-height: 1;
+}
+
+.form-section-title {
+  flex: 1;
+}
+
+.form-section-title h2 {
+  font-size: 1.3rem;
+  color: #2e7d32;
+  margin: 0 0 0.25rem 0;
+  font-weight: 600;
+}
+
+.form-section-title p {
+  font-size: 0.9rem;
+  color: #757575;
+  margin: 0;
+  font-weight: normal;
+}
+
+.form-section-content {
+  margin-top: 1rem;
+}
+
+/* Collapsible Sections */
+.form-section.collapsible .form-section-header {
+  cursor: pointer;
+  user-select: none;
+  transition: background-color 0.2s;
+  margin: -1.5rem -1.5rem 0 -1.5rem;
+  padding: 1.5rem;
+  border-radius: 12px 12px 0 0;
+}
+
+.form-section.collapsible .form-section-header:hover {
+  background-color: rgba(46, 125, 50, 0.05);
+}
+
+.form-section-toggle {
+  font-size: 1.2rem;
+  color: #2e7d32;
+  transition: transform 0.2s;
+}
+
+.form-section.collapsed .form-section-toggle {
+  transform: rotate(-90deg);
+}
+
+.form-section.collapsed .form-section-content {
+  display: none;
+}
+
+/* Subsection Styling */
+.form-subsection {
+  background: white;
+  border: 1px solid #e0e0e0;
+  border-radius: 8px;
+  padding: 1.25rem;
+  margin-bottom: 1rem;
+}
+
+.form-subsection:last-child {
+  margin-bottom: 0;
+}
+
+.form-subsection-header {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  margin-bottom: 1rem;
+}
+
+.form-subsection-icon {
+  font-size: 1.2rem;
+  line-height: 1;
+}
+
+.form-subsection-header h3 {
+  font-size: 1.1rem;
+  color: #424242;
+  margin: 0;
+  font-weight: 600;
+}
+
 .filter-chips {
   display: flex;
   flex-wrap: wrap;

packages/web/src/styles/EditCookbook.css

@@ -74,6 +74,111 @@
   font-weight: normal;
 }
 
+/* Form Sections with Visual Hierarchy */
+.form-section {
+  background: #fafafa;
+  border: 2px solid #e0e0e0;
+  border-radius: 12px;
+  padding: 1.5rem;
+  margin-bottom: 2rem;
+}
+
+.form-section-header {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  margin-bottom: 1rem;
+  padding-bottom: 0.75rem;
+  border-bottom: 2px solid #e0e0e0;
+}
+
+.form-section-icon {
+  font-size: 1.5rem;
+  line-height: 1;
+}
+
+.form-section-title {
+  flex: 1;
+}
+
+.form-section-title h2 {
+  font-size: 1.3rem;
+  color: #2e7d32;
+  margin: 0 0 0.25rem 0;
+  font-weight: 600;
+}
+
+.form-section-title p {
+  font-size: 0.9rem;
+  color: #757575;
+  margin: 0;
+  font-weight: normal;
+}
+
+.form-section-content {
+  margin-top: 1rem;
+}
+
+/* Collapsible Sections */
+.form-section.collapsible .form-section-header {
+  cursor: pointer;
+  user-select: none;
+  transition: background-color 0.2s;
+  margin: -1.5rem -1.5rem 0 -1.5rem;
+  padding: 1.5rem;
+  border-radius: 12px 12px 0 0;
+}
+
+.form-section.collapsible .form-section-header:hover {
+  background-color: rgba(46, 125, 50, 0.05);
+}
+
+.form-section-toggle {
+  font-size: 1.2rem;
+  color: #2e7d32;
+  transition: transform 0.2s;
+}
+
+.form-section.collapsed .form-section-toggle {
+  transform: rotate(-90deg);
+}
+
+.form-section.collapsed .form-section-content {
+  display: none;
+}
+
+/* Subsection Styling */
+.form-subsection {
+  background: white;
+  border: 1px solid #e0e0e0;
+  border-radius: 8px;
+  padding: 1.25rem;
+  margin-bottom: 1rem;
+}
+
+.form-subsection:last-child {
+  margin-bottom: 0;
+}
+
+.form-subsection-header {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  margin-bottom: 1rem;
+}
+
+.form-subsection-icon {
+  font-size: 1.2rem;
+  line-height: 1;
+}
+
+.form-subsection-header h3 {
+  font-size: 1.1rem;
+  color: #424242;
+  margin: 0;
+  font-weight: 600;
+}
+
 .filter-chips {
   display: flex;
   flex-wrap: wrap;