add list of users

2 files changed, 14 insertions, 0 deletions

diff --git a/README.md b/README.md
index 02eabff..92862e8 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,9 @@ The goal is for me to only need to modify `colors/colors.sh` and the explanation
 ## Screenshots
 ![Starlight](data/starlight.png)
 
+## Users
+You can find a list of things using starlight in the [USERS](USERS.md) file.
+
 ## Goals
 * All base colors (black, red, green, yellow, blue, magenta, cyan, white) should be easily uniquely identifiable.
 * Bright variants should be identifiable side by side, but do not need to be uniquely identifiable.
diff --git a/USERS.md b/USERS.md
new file mode 100644
index 0000000..641fe42
--- /dev/null
+++ b/USERS.md
@@ -0,0 +1,11 @@
+# Users
+The following projects use starlight, grouped by use type, in alphabetical order.
+
+## As an ANSI theme
+A star (*) indicates that a version of starlight is the default theme.
+
+* the [foot](https://codeberg.org/dnkl/foot) terminal emulator*
+
+## As a pallete base for a theme
+
+* the [helix](https://helix-editor.com) editor ([starlight.toml](https://github.com/helix-editor/helix/blob/master/runtime/themes/starlight.toml))