diff --git a/docs/02-tutorial/02-styling.md b/docs/02-tutorial/02-styling.md
index 0aa78ba..1d4b064 100644
--- a/docs/02-tutorial/02-styling.md
+++ b/docs/02-tutorial/02-styling.md
@@ -241,6 +241,33 @@ FolderWeb automatically loads and includes page-specific styles with cache-busti
```
+## Page-Specific Scripts
+
+For small progressive enhancements, you can add a `script.js` file to a content directory:
+
+```
+content/portfolio/
+├── index.md
+├── styles.css
+└── script.js
+```
+
+**script.js:**
+```js
+// Small enhancement for this page only
+document.querySelector('.portfolio-grid')?.addEventListener('click', (e) => {
+ // ...
+});
+```
+
+FolderWeb automatically loads the script with `defer` (non-blocking) and cache-busting:
+
+```html
+
+```
+
+The script tag is placed before ``, so it runs after the page has been parsed. This is ideal for progressive enhancement — the page works without JavaScript, but gets enhanced when it's available.
+
## Dark Mode
Add dark mode with CSS variables and `prefers-color-scheme`:
diff --git a/docs/02-tutorial/03-templates.md b/docs/02-tutorial/03-templates.md
index 5e14654..cc7d9eb 100644
--- a/docs/02-tutorial/03-templates.md
+++ b/docs/02-tutorial/03-templates.md
@@ -128,6 +128,10 @@ Let's modify `base.php` to add your site name and custom navigation: