aboutsummaryrefslogtreecommitdiff
path: root/examples/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'examples/README.md')
-rw-r--r--examples/README.md26
1 files changed, 26 insertions, 0 deletions
diff --git a/examples/README.md b/examples/README.md
new file mode 100644
index 0000000..2c601ea
--- /dev/null
+++ b/examples/README.md
@@ -0,0 +1,26 @@
+# Lustre examples
+
+Each of these examples is a complete Gleam project that contains a Lustre app
+that demos or tests a particular feature of Lustre. To run any of them, navigate
+to the example's directory and first run:
+
+```sh
+$ gleam build
+```
+
+Then serve the app using `lustre/try`:
+
+```sh
+$ gleam run -m lustre/try
+```
+
+If you do not specify a target, this will attempt to serve the app using an Erlang
+HTTP server. If you'd prefer to serve using Node, you can specify the JavaScript
+target instead:
+
+```sh
+$ gleam run -m lustre/try --target javascript
+```
+
+Or you may additionally supply the `--runtime deno` flag to serve using Deno rather
+than Node.