diff --git a/justfile b/justfile
index 048a4e31..8ecc419a 100644
--- a/justfile
+++ b/justfile
@@ -29,6 +29,11 @@ test-harperjs:
yarn playwright install
yarn test
+ # Test runnable examples
+ cd "{{justfile_directory()}}/packages/harper.js/examples/commonjs-simple"
+ yarn install
+ yarn start
+
# Compile the website's dependencies and start a development server. Note that if you make changes to `harper-wasm`, you will have to re-run this command.
dev-web:
#! /bin/bash
diff --git a/packages/harper.js/examples/commonjs-simple/README.md b/packages/harper.js/examples/commonjs-simple/README.md
new file mode 100644
index 00000000..ce1691a1
--- /dev/null
+++ b/packages/harper.js/examples/commonjs-simple/README.md
@@ -0,0 +1,11 @@
+# `commonjs-simple`
+
+An example of using `harper.js` in a Node.js application.
+Read the source code in `index.cjs` to see what's going on.
+
+You can run it using Yarn:
+
+```
+yarn install
+yarn start
+```
diff --git a/packages/harper.js/examples/commonjs-simple/index.cjs b/packages/harper.js/examples/commonjs-simple/index.cjs
new file mode 100644
index 00000000..2a27a5ef
--- /dev/null
+++ b/packages/harper.js/examples/commonjs-simple/index.cjs
@@ -0,0 +1,28 @@
+let harper = require('harper.js');
+
+async function main() {
+ // We cannot use `WorkerLinter` on Node.js since it relies on web-specific APIs.
+ let linter = new harper.LocalLinter();
+
+ let lints = await linter.lint('This is a example of how to use `harper.js`.');
+
+ console.log('Here are the results of linting the above text:');
+
+ for (let lint of lints) {
+ console.log(' - ', lint.span().start, ':', lint.span().end, lint.message());
+
+ if (lint.suggestion_count() != 0) {
+ console.log('Suggestions:');
+
+ for (let sug of lint.suggestions()) {
+ console.log(
+ '\t - ',
+ sug.kind() == 1 ? 'Remove' : 'Replace with',
+ sug.get_replacement_text()
+ );
+ }
+ }
+ }
+}
+
+main();
diff --git a/packages/harper.js/examples/commonjs-simple/package.json b/packages/harper.js/examples/commonjs-simple/package.json
new file mode 100644
index 00000000..62b58e72
--- /dev/null
+++ b/packages/harper.js/examples/commonjs-simple/package.json
@@ -0,0 +1,11 @@
+{
+ "name": "commonjs-simple",
+ "version": "0.0.1",
+ "private": true,
+ "scripts": {
+ "start": "node index.cjs"
+ },
+ "dependencies": {
+ "harper.js": "^0.13.0"
+ }
+}
diff --git a/packages/harper.js/examples/commonjs-simple/yarn.lock b/packages/harper.js/examples/commonjs-simple/yarn.lock
new file mode 100644
index 00000000..fe221ca3
--- /dev/null
+++ b/packages/harper.js/examples/commonjs-simple/yarn.lock
@@ -0,0 +1,14 @@
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
+# yarn lockfile v1
+
+
+harper.js@^0.13.0:
+ version "0.13.0"
+ resolved "https://registry.yarnpkg.com/harper.js/-/harper.js-0.13.0.tgz#f9e945c842f4e07e1b7042e3eef00a8040b2e0dd"
+ integrity sha512-XjiQG7kpooKCU2xp46mvNra9PUq5n3z5kXOaWvKjOBRyWIllvuEwvDv40cEUODhWD2ABVTEMea8odXRORfyruw==
+ dependencies:
+ wasm "link:../../../../../../.cache/yarn/v6/npm-harper-js-0.13.0-f9e945c842f4e07e1b7042e3eef00a8040b2e0dd-integrity/harper-wasm/pkg"
+
+"wasm@link:../../harper-wasm/pkg":
+ version "0.0.0"
+ uid ""
diff --git a/packages/harper.js/examples/raw-web/README.md b/packages/harper.js/examples/raw-web/README.md
new file mode 100644
index 00000000..14e01815
--- /dev/null
+++ b/packages/harper.js/examples/raw-web/README.md
@@ -0,0 +1,4 @@
+# `raw-web`
+
+An example of using `harper.js` in a raw HTML webpage.
+You can open it using [`microserver`](https://crates.io/crates/microserver):
diff --git a/packages/harper.js/examples/raw-web/index.html b/packages/harper.js/examples/raw-web/index.html
new file mode 100644
index 00000000..6940b194
--- /dev/null
+++ b/packages/harper.js/examples/raw-web/index.html
@@ -0,0 +1,53 @@
+
+
+
+
+
+
+
+
+
+
+
Demo
+
+
+ This page is a simple example of using harper.js on a plain HTML page with a CDN.
+ It isn't pretty, but it demonstrates the fundamentals of using Harper.
+ Start typing in the text box below to start getting suggestions right in your browser.
+