Skip to content

KikuAI-Lab/email-send-ready-qa

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Email Campaign Send-Ready QA Demo

Email Campaign Send-Ready QA is a browser-local demo for checking AI-edited HTML emails before send.

Try the hosted tool · Run locally

Docs · Examples · Checks

Email Campaign Send-Ready QA browser-local HTML email checker

Sample output:

Check: missing preheader
Action: review suggested fix, preview locally, export fixed HTML

Quickstart

Run a local static server:

python3 -m http.server 4173

Then open http://localhost:4173/.

Expected result: a local QA surface where sample HTML can be analyzed, safely fixed, previewed, and exported without network calls.

Checks

npm run check

Expected result:

emailQa.test.mjs: PASS
noNetwork.test.mjs: PASS

Scope

  • Paste or load sample HTML.
  • Run deterministic pre-send checks.
  • Apply conservative safe fixes.
  • Export fixed HTML and a QA report.
  • The standalone app has no backend, accounts, telemetry, storage, or network calls.
  • The hosted KikuAI page may make normal site requests, but the tool does not send the campaign HTML you enter to a server.

Limitations

  • This is a deterministic pre-send checker, not an inbox-placement or deliverability guarantee.
  • Compatibility warnings use a local baseline rather than live email-client rendering.
  • Safe fixes are intentionally conservative; manual review remains part of the workflow.

Current Strengthening Layer

  • src/htmlModel.js is the parser/model adapter boundary. It keeps rule logic away from direct extraction details.
  • src/compatibility.js is the compatibility adapter. It currently uses a local deterministic baseline and is shaped to host caniemail/doiuse data later.
  • src/cssInline.js applies simple local class-rule CSS inlining when it can do so without fetching remote resources.
  • src/fixtures.js includes broken, ChatGPT-fixed, Gmail clipping, known-good, CSS-not-inlined, and Mailchimp merge-tag samples.

Active Workflow

  • Issues are grouped into Can fix automatically, Needs your input, Manual review, and Compatibility warning.
  • Each issue includes why it matters and what the user should do next.
  • Verify after ChatGPT is a first-class demo mode.
  • Safe fixes update the fixed HTML preview and the downloadable QA report.
  • The report is written as a pre-send artifact that can be shared with a client or teammate.

Verified Package Candidates

These were checked through npm but are not runtime dependencies yet:

  • parse5@8.0.1
  • htmlparser2@12.0.0
  • juice@12.1.1
  • @jsx-email/doiuse-email@1.0.4

License

AGPL-3.0. See LICENSE.

About

Browser-local pre-send QA and safe-fix demo for AI-edited HTML email campaigns.

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages