No description
Find a file
Ruben 9be457f17f Add metadata and config changes to cache invalidation
Improve cache invalidation by including metadata.ini and config file
mtimes in the cache key calculation. This ensures cache entries are
invalidated when either the content file, its metadata, or global
configuration changes.
2026-02-07 16:12:21 +01:00
app Add metadata and config changes to cache invalidation 2026-02-07 16:12:21 +01:00
devel Add performance profiling tools and test data generator 2026-01-14 14:40:57 +01:00
docs Add metadata and config changes to cache invalidation 2026-02-07 16:12:21 +01:00
.gitignore Add docs directory to gitignore 2025-11-02 13:46:05 +01:00
AGENT.md Update AGENT.md and add architecture documentation 2026-02-05 23:30:44 +01:00
README.md Update README with clearer structure and features 2025-11-02 14:36:15 +01:00

FolderWeb

Just enough, nothing more. Drop Markdown 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/
  • Multi-language support: Built-in i18n with URL prefixes
  • Template system: Override defaults with custom templates
  • Modern CSS: CSS variables, nesting, OKLCH colors, grid layouts
  • No build process: Save and refresh—see changes immediately

Example Structure

project/
├── app/                    # App (never modify)
├── content/                # Your website content
│   ├── front.md           # Home page
│   ├── about/             # About page
│   │   └── about-me.md
│   └── blog/              # Blog with list view
│       ├── metadata.ini   # Configure template
│       ├── 2025-11-01-first-post/
│       │   ├── first-post.md
│       │   ├── cover.jpg
│       │   └── metadata.ini
│       └── 2025-11-02-second-post/
│           └── another-post.md
└── custom/                # Your customizations
    ├── templates/         # Custom templates
    ├── styles/            # Custom CSS
    └── config.ini         # Configuration

Documentation

Complete documentation available in docs/

Learn More

Start with the Getting Started Tutorial or browse the complete documentation.