diff --git a/README.md b/README.md
new file mode 100644
index 0000000..af0255f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+# drupal-nix-flake-example
+
+Run `nix run` to start the project.
+
+Run `nix develop` to enter the dev shell to access PHP and Composer, or use direnv.
+
+Install Drupal:
+
+    drush site:install --db-url=mysql://root@127.0.0.1/drupal_nix_flake_example
+
+Add `drupal/core-dev` to run tests:
+
+    composer require --dev drupal/core-dev
+