No description
Find a file
Ruben f8a352afce Add JavaScript support to page templates
Add support for page-specific JavaScript files with cache busting
via MD5 hash. The script is loaded at the end of the body with
defer attribute. The JavaScript file must be named script.js and
located in the same directory as the page content.
2026-02-06 18:47:17 +01:00
app Add JavaScript support to page templates 2026-02-06 18:47:17 +01:00
devel Add performance profiling tools and test data generator 2026-01-14 14:40:57 +01:00
docs Add Atom feed support to list pages 2026-02-06 18:24:39 +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.