diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..2752eb9
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,2 @@
+node_modules/
+.DS_Store
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..48a32c3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# nibling.run
+
+`nibling.run` is a dev sandbox that runs entirely in your browser, built for realtime collaboration.
+
+## Packages
+
+- `runtime` is the sandbox core
+
+## Principles
+
+- Defer to the web platform
+- Keep bytes-over-the-wire minimal
+- Prioritize performance: maximize parallelization of critical work, defer loading optional modules until there's a strong signal they'll be used
+- Adhere to the Unix philosophy of composable, single-purpose modules
+- Agents are realtime collaborators—the same techniques that support resilient realtime human collaboration also serve parallel agent sessions