diff --git a/README.md b/README.md
index 61e7391..e4ae9d9 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,26 @@
 # la-huasca-ts
 
-TypeScript + Next.js version of La Huasca
\ No newline at end of file
+TypeScript + Next.js version of La Huasca.
+
+A minimal Next.js 14+ App Router scaffold using TypeScript, with [`@chenglou/pretext`](https://github.com/chenglou/pretext) installed. The landing page demonstrates a Pretext-based text measurement in a client component (`src/components/MeasuredText.tsx`).
+
+## Getting started
+
+```bash
+npm install
+npm run dev
+```
+
+Open [http://localhost:3000](http://localhost:3000).
+
+## Project structure
+
+```
+package.json
+next.config.js
+tsconfig.json
+src/app/layout.tsx
+src/app/page.tsx
+src/components/MeasuredText.tsx
+README.md
+```