folderweb/README.md

1.8 KiB

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.