init: seeding the project repo

README.md

@@ -1,3 +1,16 @@
-# repo-seed
+# 🧪 TestDrive UI
 
-A git repository template to bootstrap coulomb projects from.
+Baseline scaffold for test-driven browser UI component development with **Lit**, **Mocha**, and **jsdom**.
+
+### Commands
+
+| Command | Description |
+|----------|-------------|
+| `npm install` | Install dependencies |
+| `npm test` | Run all Mocha tests headlessly |
+| `npm run dev` | Start Vite dev server and preview components |
+
+### Folder layout
+- `src/components/` — individual components (each with .js, .test.js, .stories.js)
+- `test/setup.js` — shared JSDOM environment
+- `vite.config.js` — dev preview config