🌊 WaveEditor

A self-hosted, white-labeled rich-text editor for the web. Drop-in replacement for TinyMCE — without the API key, the external CDN, or the surprise bills.

🎯 v0.9.0 — Phase 2 cut #4: polish + tinymce-clone theme (soft-launch). Everything from v0.8.0 plus visual-blocks debug toggle, markdown-shortcut marker (typing **bold** / # h1 / > bq / - list / 1. list already works via StarterKit input rules), templates/snippets (config-driven popover), and the opt-in waveeditor.tinymce-clone.min.css theme — link this stylesheet instead of waveeditor.min.css for a TinyMCE-7 visual match (blue accent, gray toolbar, 28px buttons). 586 unit tests + 74 e2e tests, 94 KB gzipped. Last window for breaking API changes before v1.0.0 locks the surface; see docs/phases/phase-2.md.

What WaveEditor is

WaveEditor gives web developers a rich-text editor that is owned by the people who use it:

• ✅ Drop-in replacement for TinyMCE — public API mirrors tinymce.init({...}) so existing codebases migrate with a find-and-replace
• ✅ Self-hosted — single JS + CSS pair, no external CDN, no API key, works offline and behind firewalls
• ✅ MIT-licensed open core — no GPL contagion, no recurring fees
• ✅ Brandable — full white-label support via CSS variables; ship it under your own product name
• ✅ Commercial-ready — clean separation between free core (Phases 0–3) and future paid tier (Phase 4)

Package

Published on npm as @waveeditor/core.

The unscoped waveeditor name is blocked by npm's anti-typosquatting policy (similarity to the unrelated wangeditor package), so we use the @waveeditor org scope — same convention as TipTap (@tiptap/core), Lexical (@lexical/core), CKEditor 5 (@ckeditor/*). Brand identity stays "WaveEditor" everywhere except the install command.

Quick start

Via npm

npm install @waveeditor/core

import { WaveEditor } from '@waveeditor/core';
import '@waveeditor/core/dist/waveeditor.min.css';

WaveEditor.init({
  selector: '#editor',
  plugins:
    'undo redo bold italic underline strikethrough subscript superscript ' +
    'heading blockquote bullet-list ordered-list indent outdent ' +
    'align-left align-center align-right align-justify ' +
    'link unlink image clear-formatting horizontal-rule ' +
    'source-view fullscreen word-count clipboard',
  toolbar:
    'undo redo | bold italic underline strikethrough | ' +
    'heading blockquote | bullet-list ordered-list indent outdent | ' +
    'align-left align-center align-right align-justify | ' +
    'link unlink image | source-view fullscreen',
});

Via CDN (drop-in, no build step)

<link rel="stylesheet" href="https://unpkg.com/@waveeditor/core/dist/waveeditor.min.css">
<script src="https://unpkg.com/@waveeditor/core/dist/waveeditor.min.js"></script>

For a TinyMCE-7 visual match (smaller buttons, lighter toolbar, TinyMCE blue accent), swap the stylesheet — JS is unchanged:

<link rel="stylesheet" href="https://unpkg.com/@waveeditor/core/dist/waveeditor.tinymce-clone.min.css">

<div id="editor"></div>
<script>
  WaveEditor.init({
    selector: '#editor',
    plugins: 'bold italic link image bullet-list',
    toolbar: 'bold italic | link image | bullet-list',
  });
</script>

Identical pattern to TinyMCE. Same config string format. Just tinymce.init → WaveEditor.init.

Currently shipped (through v0.9.0)

See docs/api.md for the full public API reference and docs/plugins.md for writing custom plugins.

Examples

HTML demos in examples/ that you can open via npm run dev:

• examples/basic.html — minimal hello-world drop-in (Phase 0 baseline)
• examples/full-toolbar.html — every currently-shipped feature
• examples/phase-1-preview.html — Phase 1 frozen snapshot
• examples/phase-2-preview.html — Phase 2 in-progress delivery record
• examples/tinymce-migration.html — TinyMCE and WaveEditor side-by-side, identical config strings (§1.16.2)
• examples/docs.html — designed developer guide with live demo

Testing

npm test           # 586 unit tests
npm run e2e        # Playwright e2e — 25 specs × chromium / firefox / webkit
npm run build      # produces dist/ — waveeditor.min.{js,css} (94 KB / 5 KB gz)
                   #              + waveeditor.tinymce-clone.min.css (5.5 KB gz)
npm run license:audit  # fails on GPL/AGPL/SSPL

Roadmap

Documentation

Built on

• TipTap — editor engine (MIT)
• ProseMirror — underlying document model (MIT)
• Tabler Icons — icon set (MIT)
• Inter — chrome typeface (OFL)
• JetBrains Mono — monospace typeface (OFL)

Full third-party attributions: NOTICES.md.

Contributing

See CONTRIBUTING.md for the contribution workflow. The architecture rules and project conventions live in CLAUDE.md.

Security

Found a vulnerability? See SECURITY.md for the responsible disclosure process.

License

MIT — © 2026 Manish Patolia.

WaveEditor is built on MIT-licensed open-source components and is itself MIT-licensed. Commercial premium features (Phase 4+) may be offered under a dual-license model in the future; see docs/design.md §16.