folderweb/README.md

# FolderWeb

**Just enough, nothing more.** Drop content files in folders, and they become pages. No database, no build process.

## What is FolderWeb?

FolderWeb is a content publishing framework where your file system is your content management system. Create a folder structure that mirrors your site hierarchy, drop files into folders, and they immediately become pages.

**Core principle**: Simplicity and longevity over features and complexity.

## Key Features

- **File-based routing**: `content/blog/post/` → `yoursite.com/blog/post/`
- **Multiple content formats**: Write in Markdown, HTML, or PHP — and mix them freely within the same page. Use Markdown for prose, HTML for structured sections, and PHP when you need dynamic output. Prefix filenames with numbers (`10-intro.md`, `20-gallery.html`) to control render order.
- **Template system**: Override any default template with your own
- **Multi-language support**: Built-in i18n with URL prefixes and per-file translations
- **Modern CSS**: CSS variables, nesting, OKLCH colors, grid layouts
- **No build process**: Save and refresh — see changes immediately

## Example Structure

```
project/
├── app/                    # Application (never modify)
├── content/                # Your website content
│   ├── front.md           # Home page
│   ├── about/
│   │   └── about-me.md
│   ├── portfolio/
│   │   ├── 10-intro.md            # Markdown prose
│   │   ├── 20-gallery.html        # HTML layout
│   │   └── 30-stats.php           # Dynamic PHP output
│   └── blog/
│       ├── metadata.ini
│       ├── 2025-11-01-first-post/
│       │   ├── first-post.md
│       │   ├── cover.jpg
│       │   └── metadata.ini
│       └── 2025-11-02-second-post/
│           └── post.md
└── custom/                # Your customizations
    ├── templates/
    ├── styles/
    └── config.ini
```

## Documentation

Complete documentation available in [`docs/`](docs/).

Start with the **[Getting Started guide](docs/01-getting-started/index.md)** or browse the **[tutorial](docs/02-tutorial/)**.
Update framework documentation and rename project to FolderWeb 2025-11-01 17:23:11 +01:00			`# FolderWeb`
Initial commit 2025-10-02 16:54:47 +02:00
Update documentation for mixed content formats and ordering Clarify that content files can be Markdown, HTML, or PHP Add explanation of numbered prefixes for file ordering Update example structures to reflect new capabilities Standardize documentation links and formatting 2026-02-07 18:59:41 +01:00			`Just enough, nothing more. Drop content files in folders, and they become pages. No database, no build process.`
Initial commit 2025-10-02 16:54:47 +02:00
Update README with clearer structure and features 2025-11-02 14:36:15 +01:00			`## What is FolderWeb?`
Initial commit 2025-10-02 16:54:47 +02:00
Update README with clearer structure and features 2025-11-02 14:36:15 +01:00			`FolderWeb is a content publishing framework where your file system is your content management system. Create a folder structure that mirrors your site hierarchy, drop files into folders, and they immediately become pages.`
Initial commit 2025-10-02 16:54:47 +02:00
Update README with clearer structure and features 2025-11-02 14:36:15 +01:00			`Core principle: Simplicity and longevity over features and complexity.`
Initial commit 2025-10-02 16:54:47 +02:00
Update README with clearer structure and features 2025-11-02 14:36:15 +01:00			`## Key Features`
Initial commit 2025-10-02 16:54:47 +02:00
Update README with clearer structure and features 2025-11-02 14:36:15 +01:00			- File-based routing: `content/blog/post/` → `yoursite.com/blog/post/`
Update documentation for mixed content formats and ordering Clarify that content files can be Markdown, HTML, or PHP Add explanation of numbered prefixes for file ordering Update example structures to reflect new capabilities Standardize documentation links and formatting 2026-02-07 18:59:41 +01:00			- Multiple content formats: Write in Markdown, HTML, or PHP — and mix them freely within the same page. Use Markdown for prose, HTML for structured sections, and PHP when you need dynamic output. Prefix filenames with numbers (`10-intro.md`, `20-gallery.html`) to control render order.
			`- Template system: Override any default template with your own`
			`- Multi-language support: Built-in i18n with URL prefixes and per-file translations`
Update README with clearer structure and features 2025-11-02 14:36:15 +01:00			`- Modern CSS: CSS variables, nesting, OKLCH colors, grid layouts`
Update documentation for mixed content formats and ordering Clarify that content files can be Markdown, HTML, or PHP Add explanation of numbered prefixes for file ordering Update example structures to reflect new capabilities Standardize documentation links and formatting 2026-02-07 18:59:41 +01:00			`- No build process: Save and refresh — see changes immediately`
Update framework documentation and rename project to FolderWeb 2025-11-01 17:23:11 +01:00
Update README with clearer structure and features 2025-11-02 14:36:15 +01:00			`## Example Structure`
Add multi-file page support and improve documentation Update README to explain multi-file page functionality Add example content files demonstrating the feature Improve folder type detection logic Implement new routing for page-type folders Add support for mixed content types in single pages Update navigation and metadata handling for multi-file pages Remove legacy frontpage.php in favor of multi-file approach Improve file-based routing documentation Add examples of different content types working together Update router to handle multi-file content rendering Implement proper sorting of content files Add best practices for multi-file content organization 2025-11-01 18:20:23 +01:00
			```
Update README with clearer structure and features 2025-11-02 14:36:15 +01:00			`project/`
Update documentation for mixed content formats and ordering Clarify that content files can be Markdown, HTML, or PHP Add explanation of numbered prefixes for file ordering Update example structures to reflect new capabilities Standardize documentation links and formatting 2026-02-07 18:59:41 +01:00			`├── app/ # Application (never modify)`
Update README with clearer structure and features 2025-11-02 14:36:15 +01:00			`├── content/ # Your website content`
			`│ ├── front.md # Home page`
Update documentation for mixed content formats and ordering Clarify that content files can be Markdown, HTML, or PHP Add explanation of numbered prefixes for file ordering Update example structures to reflect new capabilities Standardize documentation links and formatting 2026-02-07 18:59:41 +01:00			`│ ├── about/`
Update README with clearer structure and features 2025-11-02 14:36:15 +01:00			`│ │ └── about-me.md`
Update documentation for mixed content formats and ordering Clarify that content files can be Markdown, HTML, or PHP Add explanation of numbered prefixes for file ordering Update example structures to reflect new capabilities Standardize documentation links and formatting 2026-02-07 18:59:41 +01:00			`│ ├── portfolio/`
			`│ │ ├── 10-intro.md # Markdown prose`
			`│ │ ├── 20-gallery.html # HTML layout`
			`│ │ └── 30-stats.php # Dynamic PHP output`
			`│ └── blog/`
			`│ ├── metadata.ini`
Update README with clearer structure and features 2025-11-02 14:36:15 +01:00			`│ ├── 2025-11-01-first-post/`
			`│ │ ├── first-post.md`
			`│ │ ├── cover.jpg`
			`│ │ └── metadata.ini`
			`│ └── 2025-11-02-second-post/`
Update documentation for mixed content formats and ordering Clarify that content files can be Markdown, HTML, or PHP Add explanation of numbered prefixes for file ordering Update example structures to reflect new capabilities Standardize documentation links and formatting 2026-02-07 18:59:41 +01:00			`│ └── post.md`
Update README with clearer structure and features 2025-11-02 14:36:15 +01:00			`└── custom/ # Your customizations`
Update documentation for mixed content formats and ordering Clarify that content files can be Markdown, HTML, or PHP Add explanation of numbered prefixes for file ordering Update example structures to reflect new capabilities Standardize documentation links and formatting 2026-02-07 18:59:41 +01:00			`├── templates/`
			`├── styles/`
			`└── config.ini`
Add multi-file page support and improve documentation Update README to explain multi-file page functionality Add example content files demonstrating the feature Improve folder type detection logic Implement new routing for page-type folders Add support for mixed content types in single pages Update navigation and metadata handling for multi-file pages Remove legacy frontpage.php in favor of multi-file approach Improve file-based routing documentation Add examples of different content types working together Update router to handle multi-file content rendering Implement proper sorting of content files Add best practices for multi-file content organization 2025-11-01 18:20:23 +01:00			```

Update README with clearer structure and features 2025-11-02 14:36:15 +01:00			`## Documentation`
Add multi-file page support and improve documentation Update README to explain multi-file page functionality Add example content files demonstrating the feature Improve folder type detection logic Implement new routing for page-type folders Add support for mixed content types in single pages Update navigation and metadata handling for multi-file pages Remove legacy frontpage.php in favor of multi-file approach Improve file-based routing documentation Add examples of different content types working together Update router to handle multi-file content rendering Implement proper sorting of content files Add best practices for multi-file content organization 2025-11-01 18:20:23 +01:00
Update documentation for mixed content formats and ordering Clarify that content files can be Markdown, HTML, or PHP Add explanation of numbered prefixes for file ordering Update example structures to reflect new capabilities Standardize documentation links and formatting 2026-02-07 18:59:41 +01:00			Complete documentation available in [`docs/`](docs/).
Add multi-file page support and improve documentation Update README to explain multi-file page functionality Add example content files demonstrating the feature Improve folder type detection logic Implement new routing for page-type folders Add support for mixed content types in single pages Update navigation and metadata handling for multi-file pages Remove legacy frontpage.php in favor of multi-file approach Improve file-based routing documentation Add examples of different content types working together Update router to handle multi-file content rendering Implement proper sorting of content files Add best practices for multi-file content organization 2025-11-01 18:20:23 +01:00
Update documentation for mixed content formats and ordering Clarify that content files can be Markdown, HTML, or PHP Add explanation of numbered prefixes for file ordering Update example structures to reflect new capabilities Standardize documentation links and formatting 2026-02-07 18:59:41 +01:00			`Start with the [Getting Started guide](docs/01-getting-started/index.md) or browse the [tutorial](docs/02-tutorial/).`