Skip to content

Report email: summary first, square corners, plain words - #247

Merged
MeharPro merged 1 commit into
mainfrom
fix/report-email-summary-first
Nov 16, 2026
Merged

MeharPro merged 1 commit into
mainfrom
fix/report-email-summary-first

Conversation

@MeharPro

Copy link
Copy Markdown
Contributor

The owner said on 2026-11-15 that the report email looked AI-generated, was hard to read and had rounded corners. This PR rewrites the layout in telemetry-worker/src/report-email.ts. What goes into a report (report.ts) and how it is sent are unchanged.

What changed

  • Summary first. The email opens with a headline, a few short sentences (what happened, what to do first) and one button. The details come below a rule.
    • Before any data arrives, the summary names the app and says how to connect it.
    • Once an app has data, the model's summary leads, with its next steps.
    • The inbox preview line is now the summary instead of "GenClass Nov 15… DAILY REPORT".
  • Square. No border-radius anywhere: zero elements with a corner radius in the rendered page. There are also no pills, round dots, emoji, uppercase eyebrow labels or arrows.
    • One column with 1px rules between sections, instead of a card per section.
    • Priority is shown by a 3px coloured bar and a word ("Critical").
  • Plain. The "0 critical / 0 important / 0 worth a look" chips are gone; the counts line shows only numbers above 0, and only once an app has data.
    • Sections with nothing new fold into one quiet line.
    • A single alert says it once.
    • Notes are shorter.
  • Looks like genclass.dev. Light colours are inline. Clients that read <style> (Apple Mail, iOS Mail, Outlook.com) get the black-and-green dark theme, through prefers-color-scheme and Outlook.com's data-ogsc/data-ogsb. This also fixes the "GenClass" wordmark, which was invisible in dark mode.
  • Email clients. Tables and inline styles, system fonts only. Outlook desktop gets a fixed 600 px column and a table-cell button.
  • Kept: the signed prompt links (printed when there's no key), the model's summary, Free's half with its counted extras and trial box, the frequency links, unsubscribe and List-Unsubscribe. The plain-text part is also summary first, and the lead's prompt link is no longer pasted into it as a long URL.

Screenshots (rendered from test fixtures in the in-app browser)

  • Before, today's "Phone isn't sending data yet" email (light, desktop):
    • A grey page with a white rounded card holding "DAILY REPORT", an orange dot and the headline.
    • Three rounded chips, "0 critical", "0 important" and "1 worth a look".
    • Then separate rounded cards: the green Free box, "Finish setting up", "Your apps" (one row: "Phone · Free · not connected yet"), "Visitors" ("…come with Pro") and "Security".
  • After, the same email (light, desktop):
    • White page. "GenClass" on the left of the header, the date on the right.
    • "Phone isn't sending data yet", then three sentences: "GenClass hasn't had a page load from Phone yet. Paste the setup prompt into your coding agent, or run npx genclass in the app's folder. Once Phone sends its first page load, this email shows what breaks there and on which pages."
    • A square green "Copy the setup prompt" button, then the square-bordered Free box.
    • Below a rule: "Finish setting up" (amber bar), "Security" (grey bar), "Ideas before the data" and the footer.
    • No chips, and no empty "Your apps" or "Visitors" cards.
  • After, dark, phone (375 px): black page with bone text, green links and a green button with dark text. There is no sideways scroll.
  • After, Pro with problems: the model's headline, its text, "1 critical · 1 important · 2 worth a look" and its 2 numbered steps with prompt links. Then come "Fix these first" (red and amber bars), the apps table, code changes, visitors, worth a look, suggestions and website design.
  • After, alert: the headline is the problem, then the app and its detail, the page, "Copy the fix prompt" and "Open the dashboard". There is no repeated details card.

Tests

  • cd telemetry-worker && npx vitest run: 32 files, 888 tests pass.
  • I added 5 tests to test/report.test.ts:
    • no radius, pills, dots or emoji in the report, alert and test emails;
    • the summary and its button come before the details, with no zero counts;
    • the case before any data;
    • several apps without data;
    • a single alert.
  • I updated 4 assertions for the new section names: "Website design", "Sites to learn from", "Ideas before the data", and the model's headline leading.

Not done: no deploy. The collector deploys from main by hand, with the owner's yes.

🤖 Generated with Claude Code

The owner (2026-11-15): the report looked AI-generated and hard to read, with rounded
corners. Now:
- The lead is a headline, a few short sentences (what happened, what to do first)
  and one button; the details follow below a rule. Before any data it names the app
  and says how to connect it; the model's summary leads once an app has data.
- No border-radius anywhere, no pills, dots, emoji or uppercase eyebrow labels. One
  column with 1px rules instead of cards; priority is a 3px bar and a coloured word.
- No "0 critical / 0 important" when everything is zero; empty sections fold into
  one quiet line; a single alert says it once.
- Looks like genclass.dev: light inline, black and green dark mode for clients that
  read <style> (prefers-color-scheme and Outlook.com), which also fixes the wordmark
  that was invisible in dark mode. Outlook gets a fixed 600 px column and a
  table-cell button. The inbox preview line is the summary.
- Signed prompt links, the model's summary, Free's half and the frequency and
  unsubscribe links are unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@MeharPro
MeharPro merged commit 2bcbd2e into main Nov 16, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant