feat(admin): give the customer emails a tab of their own (#135)

The six email templates lived at the bottom of the Settings tab, under the cart-expiry card and inside a 720px wrapper. Finding them took knowing they were there — "Settings" reads as app configuration and the only thing visible on that tab was a 480px card about cart expiry. Reaching them, the editor was then crushed: EmailTemplateEditor splits a markdown pane and a rendered preview side by side, and 720px left each half under 350px, so the preview showed the email at a width nothing like how it will be read and the markdown toolbar wrapped.

Emails is now its own tab, between Customers and Settings, with no width cap. Within it the email types are a left vertical rail rather than a strip across the top: six labels wrapped on narrower displays, and stacking them is what leaves the editor the width the split needs. Settings keeps the cart-expiry card and nothing else.

The Default/Customised tag comes off the labels. Six antd tags stacked down a rail stop it being scannable, so a customised template gets a dot and the state in full moves into the editor beside the Restore default button that acts on it. The dot carries aria-label="Customised" so the word stays in the tab's accessible name and the state is not conveyed by a mark alone.

Emails owns the fetch it inherited from Settings, and adds a Spin over it. templates starts empty, so the gap before the request lands would otherwise render an empty rail that reads as "there are no emails to edit".

Closes #135

frontend/src/admin/Admin.tsx

@@ -29,6 +29,7 @@ import {
 } from '../api';
 import { useThemeMode } from '../theme/ThemeContext';
 import Customers from './Customers';
+import Emails from './Emails';
 import Settings from './Settings';
 import Categories from './Categories';
 import Tags from './Tags';
@@ -387,6 +388,7 @@ export default function Admin() {
             { key: 'categories', label: 'Categories', children: <Categories /> },
             { key: 'tags', label: 'Tags', children: <Tags /> },
             { key: 'customers', label: 'Customers', children: <Customers /> },
+            { key: 'emails', label: 'Emails', children: <Emails /> },
             { key: 'settings', label: 'Settings', children: <Settings /> }
           ]}
         />

frontend/src/admin/EmailTemplateEditor.tsx

@@ -34,7 +34,7 @@ export default function EmailTemplateEditor({ template, onChanged }: Props) {
   const { mode } = useThemeMode();
   // Falls back to the default so the editor starts from the real copy rather
   // than an empty box. `subject`/`body` being null means "never customised",
-  // which is why the badge on the tab can say so.
+  // which is what the rail's dot and the tag below are reading.
   const [subject, setSubject] = useState(template.subject ?? template.defaultSubject);
   const [body, setBody] = useState(template.body ?? template.defaultBody);
   const [saving, setSaving] = useState(false);
@@ -139,6 +139,8 @@ export default function EmailTemplateEditor({ template, onChanged }: Props) {
           />
         </div>
 
+        {/* The rail marks a customised template with a dot only. The state in
+            full sits here, beside the button that acts on it. */}
         <Space>
           <Button type="primary" loading={saving} onClick={handleSave}>
             Save
@@ -150,6 +152,7 @@ export default function EmailTemplateEditor({ template, onChanged }: Props) {
               Restore default
             </Button>
           )}
+          {customised ? <Tag color="blue">Customised</Tag> : <Tag>Default</Tag>}
         </Space>
       </Col>
 

frontend/src/admin/Emails.tsx

@@ -0,0 +1,73 @@
+import { useEffect, useState } from 'react';
+import Tabs from 'antd/es/tabs';
+import Spin from 'antd/es/spin';
+import Typography from 'antd/es/typography';
+import message from 'antd/es/message';
+import { EmailTemplate, fetchEmailTemplates } from './emailTemplatesApi';
+import EmailTemplateEditor from './EmailTemplateEditor';
+
+const { Text } = Typography;
+
+export default function Emails() {
+  const [templates, setTemplates] = useState<EmailTemplate[]>([]);
+  const [loading, setLoading] = useState(true);
+
+  useEffect(() => {
+    fetchEmailTemplates()
+      .then(setTemplates)
+      // Reported rather than swallowed: an empty list would otherwise read as
+      // "there are no templates" instead of "they could not be loaded".
+      .catch(() => message.error('Could not load the email templates'))
+      .finally(() => setLoading(false));
+  }, []);
+
+  // Replaces the one that changed so the customised marker and the Restore
+  // button reflect what the server now holds, without refetching the rest.
+  function handleTemplateChanged(updated: EmailTemplate) {
+    setTemplates(current =>
+      current.map(t => (t.key === updated.key ? { ...t, subject: updated.subject, body: updated.body } : t))
+    );
+  }
+
+  return (
+    <div>
+      <Text type="secondary">
+        The wording customers receive. Leave one alone and it sends the built-in copy.
+      </Text>
+      {/* Spinner rather than an empty rail: with templates starting empty, the
+          gap before the fetch lands reads as "there are no emails to edit". */}
+      {loading ? (
+        <div style={{ padding: 48, textAlign: 'center' }}>
+          <Spin />
+        </div>
+      ) : (
+        /* A left rail rather than a strip across the top. Six labels wrapped on
+           narrower displays, and stacking them leaves the editor the full width
+           it needs for a markdown pane and a rendered preview side by side. */
+        <Tabs
+          tabPosition="left"
+          style={{ marginTop: 16 }}
+          items={templates.map(template => ({
+            key: template.key,
+            label: (
+              <>
+                {template.label}
+                {/* A dot, not a Tag — six tags down a rail stop it being
+                    scannable. aria-label keeps the word in the tab's
+                    accessible name, so the state is not colour-only. */}
+                {(template.subject !== null || template.body !== null) && (
+                  <span aria-label="Customised" title="Customised" style={{ marginLeft: 6 }}>
+                    •
+                  </span>
+                )}
+              </>
+            ),
+            children: (
+              <EmailTemplateEditor template={template} onChanged={handleTemplateChanged} />
+            )
+          }))}
+        />
+      )}
+    </div>
+  );
+}

frontend/src/admin/Settings.tsx

@@ -5,19 +5,13 @@ import Button from 'antd/es/button';
 import Typography from 'antd/es/typography';
 import message from 'antd/es/message';
 import Card from 'antd/es/card';
-import Tabs from 'antd/es/tabs';
-import Tag from 'antd/es/tag';
-import Space from 'antd/es/space';
 import { fetchAdminSettings, updateAdminSettings } from './adminSettingsApi';
-import { EmailTemplate, fetchEmailTemplates } from './emailTemplatesApi';
-import EmailTemplateEditor from './EmailTemplateEditor';
 
 const { Title, Text } = Typography;
 
 export default function Settings() {
   const [form] = Form.useForm();
   const [loading, setLoading] = useState(true);
-  const [templates, setTemplates] = useState<EmailTemplate[]>([]);
 
   useEffect(() => {
     fetchAdminSettings()
@@ -29,22 +23,6 @@ export default function Settings() {
       .finally(() => setLoading(false));
   }, [form]);
 
-  useEffect(() => {
-    fetchEmailTemplates()
-      .then(setTemplates)
-      // Reported rather than swallowed: an empty list would otherwise read as
-      // "there are no templates" instead of "they could not be loaded".
-      .catch(() => message.error('Could not load the email templates'));
-  }, []);
-
-  // Replaces the one that changed so the Customised badge and the Restore
-  // button reflect what the server now holds, without refetching the rest.
-  function handleTemplateChanged(updated: EmailTemplate) {
-    setTemplates(current =>
-      current.map(t => (t.key === updated.key ? { ...t, subject: updated.subject, body: updated.body } : t))
-    );
-  }
-
   async function handleSave() {
     const values = await form.validateFields();
     await updateAdminSettings(values);
@@ -52,7 +30,6 @@ export default function Settings() {
   }
 
   return (
-    <div style={{ maxWidth: 720 }}>
     <Card style={{ maxWidth: 480 }}>
       <Title level={4}>Cart Settings</Title>
       <Text type="secondary">
@@ -65,33 +42,5 @@ export default function Settings() {
         <Button type="primary" onClick={handleSave} loading={loading}>Save</Button>
       </Form>
     </Card>
-
-    <Title level={4} style={{ marginTop: 32 }}>Customer emails</Title>
-    <Text type="secondary">
-      The wording customers receive. Leave one alone and it sends the built-in copy.
-    </Text>
-    {/* Tabs rather than a stacked column. With six templates the cart reminder
-        sat below five editors, so which one you were editing was knowable only
-        from a card title you had already scrolled past. The Default/Customised
-        tag moves onto the tab label, so which templates have been changed is
-        visible without opening each one. */}
-    <Tabs
-      style={{ marginTop: 16 }}
-      items={templates.map(template => ({
-        key: template.key,
-        label: (
-          <Space size={4}>
-            {template.label}
-            {template.subject !== null || template.body !== null
-              ? <Tag color="blue">Customised</Tag>
-              : <Tag>Default</Tag>}
-          </Space>
-        ),
-        children: (
-          <EmailTemplateEditor template={template} onChanged={handleTemplateChanged} />
-        )
-      }))}
-    />
-    </div>
   );
 }