diff --git a/README.md b/README.md
index f86e9bf..1c58920 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,7 @@
I often wonder what it would look like to build sites & apps knowing just the basics.
I thought:
+
- What if I knew how to write HTML and I can have a dynamic web page from that?
- What if I knew how to build custom elements and that's all the component system I needed?
- What if I can write HTML fragments and assemble them easily in a page?
@@ -25,10 +26,13 @@ I thought:
**McFly** is my reimagination of web development: Back to the basics. Into the future.
## Project Status
+
We are currently in a Proof of Concept phase. All parts are subject to breaking changes in minor releases.
## Try it today
+
Run the following to generate a McFly starter project.
+
```
npm create mcfly@latest
```
@@ -42,36 +46,43 @@ npm create mcfly@latest
✅ Deploy anywhere, even the Edge
## Special directories
+
**1. `./src/pages/`**
+
- file-based routing for `.html` files
- directly use custom elements & static fragments (no imports or registry maintenance needed)
- use `