diff --git a/app/default/content/about/metadata.ini b/app/default/content/about/metadata.ini
new file mode 100644
index 0000000..7e73f4a
--- /dev/null
+++ b/app/default/content/about/metadata.ini
@@ -0,0 +1,3 @@
+title = "About FolderWeb"
+menu = true
+menu_order = 2
diff --git a/app/default/content/about/page.md b/app/default/content/about/page.md
new file mode 100644
index 0000000..e400e3e
--- /dev/null
+++ b/app/default/content/about/page.md
@@ -0,0 +1,89 @@
+# About FolderWeb
+
+FolderWeb is a minimalist PHP framework designed for simplicity, longevity, and maintainability. It's built on a simple philosophy: **just enough, nothing more**.
+
+## Philosophy
+
+Modern web development has become unnecessarily complex. Build tools, package managers, JavaScript frameworks that change every few months—it's exhausting and unsustainable.
+
+FolderWeb is different. It's built to:
+
+- **Work for decades** without requiring constant updates
+- **Be understandable** by reading a few hundred lines of code
+- **Stay maintainable** without specialized knowledge
+- **Load fast** with no JavaScript overhead
+- **Just work** without configuration or setup
+
+## Design Principles
+
+### Minimalism
+Use only what is strictly necessary. No frameworks, no build tools, no package managers for frontend code. Every line of code must justify its existence.
+
+### File-Based Everything
+Your folder structure is your URL structure. Drop a file in a folder and it's instantly accessible. No routes to configure, no databases to set up.
+
+### Override, Never Modify
+Custom templates and styles go in `/custom/` and automatically override defaults. The core files in `/app/default/` remain untouched and updateable.
+
+### Modern Standards
+Use modern PHP 8.3+ features and modern CSS capabilities. Avoid JavaScript entirely—it's not needed for content-focused sites.
+
+## Technology Stack
+
+### Backend
+- **PHP 8.3+** - Modern PHP with type hints, arrow functions, match expressions
+- **Apache** - With mod_rewrite for clean URLs
+- **Parsedown** - Simple, reliable Markdown parser
+
+### Frontend
+- **HTML5** - Semantic markup following best practices
+- **CSS3** - Modern features like Grid, clamp(), OKLCH colors, CSS nesting
+- **No JavaScript** - By design, for faster loads and simpler maintenance
+
+## What It's Not
+
+FolderWeb is **not**:
+
+- A CMS with an admin panel
+- A single-page application framework
+- A solution for complex web applications
+- Trying to scale to millions of users
+- Following current trends and fads
+
+## What It Is
+
+FolderWeb **is**:
+
+- A simple way to publish content
+- A foundation that will work for decades
+- A teaching tool for web fundamentals
+- A protest against unnecessary complexity
+- Perfect for documentation, blogs, portfolios, small business sites
+
+## Use Cases
+
+FolderWeb excels at:
+
+- **Documentation sites** - Clear structure, easy to navigate
+- **Personal blogs** - Simple publishing workflow
+- **Portfolio sites** - Showcase your work without bloat
+- **Small business sites** - Professional presence without complexity
+- **Project pages** - Quick site for your open source project
+
+## Who Created This?
+
+FolderWeb emerged from frustration with modern web development complexity. It's built for developers who appreciate simplicity and maintainability over features and frameworks.
+
+## License
+
+FolderWeb is open source. Check the repository for license details.
+
+## Get Started
+
+Ready to build something simple and lasting?
+
+1. Create a `/content` folder
+2. Add your first `.md` file
+3. That's it—you're publishing
+
+No build step. No npm install. No configuration files. Just content.
diff --git a/app/default/content/articles/2025-10-15-markdown-guide/article.md b/app/default/content/articles/2025-10-15-markdown-guide/article.md
new file mode 100644
index 0000000..a3bc6d2
--- /dev/null
+++ b/app/default/content/articles/2025-10-15-markdown-guide/article.md
@@ -0,0 +1,206 @@
+# Markdown Guide
+
+Markdown is a lightweight markup language that's easy to write and read. FolderWeb uses [Parsedown](https://parsedown.org/) to convert your Markdown files into beautiful HTML.
+
+## Headings
+
+Use `#` symbols for headings:
+
+```markdown
+# Heading 1
+## Heading 2
+### Heading 3
+#### Heading 4
+##### Heading 5
+###### Heading 6
+```
+
+## Emphasis
+
+Make text **bold** or *italic*:
+
+```markdown
+*italic text* or _italic text_
+**bold text** or __bold text__
+***bold and italic*** or ___bold and italic___
+```
+
+## Lists
+
+### Unordered Lists
+
+```markdown
+- Item one
+- Item two
+- Item three
+ - Nested item
+ - Another nested item
+```
+
+### Ordered Lists
+
+```markdown
+1. First item
+2. Second item
+3. Third item
+ 1. Nested item
+ 2. Another nested item
+```
+
+## Links
+
+```markdown
+[Link text](https://example.com)
+[Link with title](https://example.com "Title text")
+```
+
+Example: [Visit FolderWeb](#)
+
+## Images
+
+```markdown
+
+
+```
+
+## Code
+
+### Inline Code
+
+Use backticks for `inline code`:
+
+```markdown
+Use the `$variable` in your code
+```
+
+### Code Blocks
+
+Use triple backticks for code blocks:
+
+````markdown
+```php
+
+```
+````
+
+Renders as:
+
+```php
+
+```
+
+## Blockquotes
+
+```markdown
+> This is a blockquote.
+> It can span multiple lines.
+>
+> And multiple paragraphs.
+```
+
+Result:
+
+> This is a blockquote.
+> It can span multiple lines.
+
+## Horizontal Rules
+
+Create a horizontal rule with three or more hyphens, asterisks, or underscores:
+
+```markdown
+---
+***
+___
+```
+
+---
+
+## Tables
+
+```markdown
+| Header 1 | Header 2 | Header 3 |
+|----------|----------|----------|
+| Cell 1 | Cell 2 | Cell 3 |
+| Cell 4 | Cell 5 | Cell 6 |
+```
+
+Result:
+
+| Header 1 | Header 2 | Header 3 |
+|----------|----------|----------|
+| Cell 1 | Cell 2 | Cell 3 |
+| Cell 4 | Cell 5 | Cell 6 |
+
+## Best Practices
+
+### Use Semantic Structure
+
+Start with `# H1` for your page title, then use `## H2`, `### H3`, etc. for sections.
+
+### Write Readable Markdown
+
+```markdown
+# Good Example
+
+This paragraph is easy to read with proper spacing.
+
+## Section Heading
+
+- List items are clear
+- Each on its own line
+
+---
+
+# Bad Example
+No spacing makes it hard to read.
+##SectionWithoutSpace
+-ListItemsSmashed-Together
+```
+
+### Links in FolderWeb
+
+Internal links work best with absolute paths:
+
+```markdown
+[About page](/about/)
+[Articles](/articles/)
+[Specific article](/articles/2025-10-15-markdown-guide/)
+```
+
+## Advanced Features
+
+### HTML in Markdown
+
+You can use HTML directly in Markdown when needed:
+
+```markdown
+
+ Custom HTML content
+
+```
+
+### Escaping Characters
+
+Use backslash to escape Markdown characters:
+
+```markdown
+\*This text is not italic\*
+\[This is not a link\]
+```
+
+## Tips for FolderWeb
+
+1. **Use descriptive filenames** - `article.md` is better than `content.md`
+2. **Add metadata** - Use `metadata.ini` for titles, dates, and summaries
+3. **Include images** - Place images in the same directory as your content
+4. **Add cover images** - Use `cover.jpg` for list view thumbnails
+
+## Further Reading
+
+- [Markdown Guide](https://www.markdownguide.org/) - Comprehensive Markdown reference
+- [Parsedown Documentation](https://parsedown.org/) - The parser FolderWeb uses
+- [CommonMark Spec](https://commonmark.org/) - Markdown specification
diff --git a/app/default/content/articles/2025-10-15-markdown-guide/metadata.ini b/app/default/content/articles/2025-10-15-markdown-guide/metadata.ini
new file mode 100644
index 0000000..053268d
--- /dev/null
+++ b/app/default/content/articles/2025-10-15-markdown-guide/metadata.ini
@@ -0,0 +1,3 @@
+title = "Markdown Guide"
+date = "2025-10-15"
+summary = "Master Markdown syntax for beautiful, semantic content in FolderWeb."
diff --git a/app/default/content/articles/2025-10-28-templates-and-customization/article.md b/app/default/content/articles/2025-10-28-templates-and-customization/article.md
new file mode 100644
index 0000000..16c1d0c
--- /dev/null
+++ b/app/default/content/articles/2025-10-28-templates-and-customization/article.md
@@ -0,0 +1,165 @@
+# Templates and Customization
+
+FolderWeb is built on a simple principle: **never modify defaults, always override**. This guide shows you how to customize your site while keeping it maintainable.
+
+## The Override System
+
+FolderWeb checks for custom files before falling back to defaults:
+
+1. Check `/custom/templates/` → Use custom template
+2. Fall back to `/app/default/templates/` → Use default template
+
+This means you can override any part of the system without touching the core files.
+
+## Available Templates
+
+### Base Template
+The main HTML structure with header, navigation, and footer.
+
+**Override**: `/custom/templates/base.php`
+
+### Page Template
+Wraps single pages and articles.
+
+**Override**: `/custom/templates/page.php`
+
+### List Templates
+
+FolderWeb includes multiple list view variants:
+
+- `list.php` - Simple list
+- `list-grid.php` - Grid layout
+- `list-card-grid.php` - Card grid with images
+- `list-faq.php` - Expandable FAQ format
+
+**Select via metadata**:
+
+```ini
+page_template = "list-card-grid"
+```
+
+## Customizing Styles
+
+### Add Your Own CSS
+
+Create `/custom/styles/base.css` and it automatically overrides default styles.
+
+Example custom stylesheet:
+
+```css
+:root {
+ --color-primary: oklch(0.5 0.2 270);
+ --color-background: oklch(0.98 0 0);
+ --font-body: 'Georgia', serif;
+}
+
+article h1 {
+ color: var(--color-primary);
+ font-size: clamp(2rem, 5vw, 3rem);
+}
+```
+
+### Modern CSS Features
+
+FolderWeb's default styles use modern CSS:
+
+- **CSS Nesting** - Scope styles naturally
+- **OKLCH Colors** - Perceptually uniform colors
+- **CSS Grid** - Flexible layouts
+- **Clamp()** - Responsive sizing
+- **Logical Properties** - Better internationalization
+
+## Custom Fonts
+
+1. Place font files in `/custom/fonts/`
+2. Reference them in your custom CSS:
+
+```css
+@font-face {
+ font-family: 'MyFont';
+ src: url('/fonts/myfont.woff2') format('woff2');
+}
+
+body {
+ font-family: 'MyFont', sans-serif;
+}
+```
+
+## Metadata Options
+
+Control content behavior with `metadata.ini` files:
+
+```ini
+; Basic fields
+title = "Page Title"
+date = "2025-10-28"
+summary = "Short description"
+
+; Navigation
+menu = true
+menu_order = 1
+
+; Templates
+page_template = "list-card-grid"
+
+; Redirects
+redirect = "https://example.com"
+
+; Attachments
+pdf = "document.pdf"
+```
+
+## Template Variables
+
+Templates have access to specific variables:
+
+### Base Template
+- `$content` - Page content
+- `$currentLang` - Current language code
+- `$navigation` - Navigation items array
+- `$pageTitle` - Page title
+
+### Page Template
+- `$content` - Article content
+- `$pageMetadata` - Metadata array
+- `$translations` - Translation strings
+
+### List Templates
+- `$items` - Array of subitems
+- `$metadata` - Directory metadata
+- `$pageContent` - Intro text
+- `$translations` - Translation strings
+
+## Creating a Custom Template
+
+Example custom page template:
+
+```php
+
+
+
+
+
+
+ = $content ?>
+
+
+
+```
+
+## Best Practices
+
+1. **Never modify `/app/default/`** - Always create overrides in `/custom/`
+2. **Use metadata** - Keep configuration in `metadata.ini` files
+3. **Leverage CSS variables** - Easy theming without rewriting styles
+4. **Keep it simple** - The less custom code, the easier to maintain
+
+## Next Steps
+
+- Explore default templates in `/app/default/templates/`
+- Study the default CSS in `/app/default/styles/base.css`
+- Check out the [Markdown Guide](/articles/2025-10-15-markdown-guide/) for content formatting
diff --git a/app/default/content/articles/2025-10-28-templates-and-customization/metadata.ini b/app/default/content/articles/2025-10-28-templates-and-customization/metadata.ini
new file mode 100644
index 0000000..b69d0a7
--- /dev/null
+++ b/app/default/content/articles/2025-10-28-templates-and-customization/metadata.ini
@@ -0,0 +1,3 @@
+title = "Templates and Customization"
+date = "2025-10-28"
+summary = "Customize your FolderWeb site with templates, styles, and metadata options."
diff --git a/app/default/content/articles/2025-11-01-getting-started/article.md b/app/default/content/articles/2025-11-01-getting-started/article.md
new file mode 100644
index 0000000..0a1e1ce
--- /dev/null
+++ b/app/default/content/articles/2025-11-01-getting-started/article.md
@@ -0,0 +1,79 @@
+# Getting Started with FolderWeb
+
+FolderWeb is designed to be the simplest way to publish content on the web. This guide will walk you through the core concepts and get you publishing in minutes.
+
+## Installation
+
+FolderWeb requires PHP 8.3+ and Apache with `mod_rewrite` enabled.
+
+### Using Docker (Recommended for Development)
+
+```bash
+cd development
+docker compose up
+```
+
+Visit `http://localhost:8080` to see your site.
+
+### Manual Installation
+
+1. Point Apache's document root to the `/content` directory
+2. Ensure the `/app` directory is accessible at the same level
+3. Enable `mod_rewrite` in Apache
+4. That's it!
+
+## Creating Your First Page
+
+The easiest way to understand FolderWeb is to create some content.
+
+### Create a Simple Page
+
+1. Create a new directory: `/content/hello/`
+2. Add a file: `/content/hello/page.md`
+3. Write some Markdown:
+
+```markdown
+# Hello World
+
+This is my first page in FolderWeb!
+```
+
+Your page is now live at `/hello/`
+
+### Create an Article with Metadata
+
+For richer content, add metadata:
+
+1. Create: `/content/articles/2025-11-01-my-article/`
+2. Add metadata: `/content/articles/2025-11-01-my-article/metadata.ini`
+
+```ini
+title = "My First Article"
+date = "2025-11-01"
+summary = "A brief description of my article"
+```
+
+3. Add content: `/content/articles/2025-11-01-my-article/article.md`
+
+The date in the folder name is automatically extracted and displayed.
+
+## File Types
+
+FolderWeb supports three content types:
+
+- **Markdown (`.md`)** - Write in Markdown, rendered as HTML
+- **HTML (`.html`)** - Pure HTML for complete control
+- **PHP (`.php`)** - Dynamic content when needed
+
+## File Naming Conventions
+
+- **Page content**: `page.md`, `page.html`, `page.php`
+- **Articles/posts**: `article.md`, `post.md`, `single.md` (and `.html`/`.php` variants)
+- **Frontpage**: `/content/frontpage.php`
+- **Index override**: `index.php` in any directory takes precedence
+
+## Next Steps
+
+- Read the [Templates Guide](/articles/2025-10-28-templates-and-customization/) to customize your site
+- Learn [Markdown syntax](/articles/2025-10-15-markdown-guide/) for better content
+- Explore the default templates in `/app/default/templates/`
diff --git a/app/default/content/articles/2025-11-01-getting-started/metadata.ini b/app/default/content/articles/2025-11-01-getting-started/metadata.ini
new file mode 100644
index 0000000..977942b
--- /dev/null
+++ b/app/default/content/articles/2025-11-01-getting-started/metadata.ini
@@ -0,0 +1,3 @@
+title = "Getting Started with FolderWeb"
+date = "2025-11-01"
+summary = "Learn the basics of FolderWeb and create your first content in minutes."
diff --git a/app/default/content/articles/metadata.ini b/app/default/content/articles/metadata.ini
new file mode 100644
index 0000000..dbd00c7
--- /dev/null
+++ b/app/default/content/articles/metadata.ini
@@ -0,0 +1,4 @@
+title = "Articles"
+menu = true
+menu_order = 1
+page_template = "list-card-grid"
diff --git a/app/default/content/articles/page.md b/app/default/content/articles/page.md
new file mode 100644
index 0000000..9594a48
--- /dev/null
+++ b/app/default/content/articles/page.md
@@ -0,0 +1,3 @@
+# Articles
+
+A collection of guides and tutorials to help you get the most out of FolderWeb.
diff --git a/app/default/content/frontpage.php b/app/default/content/frontpage.php
new file mode 100644
index 0000000..a275eb3
--- /dev/null
+++ b/app/default/content/frontpage.php
@@ -0,0 +1,48 @@
+
+
+
Welcome to FolderWeb
+
+ A minimalist PHP framework that turns folders into websites. No JavaScript, no build tools, just simple files.
+
+
+
+
+
Getting Started
+
+ This is demo content to help you understand how FolderWeb works. To replace it with your own content:
+
+
+
Create a /content folder in your project root
+
Add your content files (.md, .html, or .php)
+
This demo will automatically disappear
+
+
+
Core Concepts
+
+
File-Based Routing
+
+ Drop a file in a folder and it's instantly accessible at a URL matching that path.
+ Your folder structure becomes your URL structure.
+
+
+
Multiple Content Types
+
+
Markdown - Write in .md files, automatically converted to HTML
+
HTML - Pure HTML files for complete control
+
PHP - Dynamic content when you need it
+
+
+
Smart Features
+
+
Metadata - Use metadata.ini files for titles, dates, summaries
+
Date extraction - Folder names like 2025-11-01-title automatically show dates
+
Cover images - Add cover.jpg for list view thumbnails
+
Templates - Custom templates in /custom/templates/ override defaults
+
+
+
Explore the Demo
+
+ Check out the Articles and About pages to see different content types in action.
+