No description
Update AGENT.md to reflect current project structure and philosophy Add comprehensive architecture documentation covering: - Directory layout - Stable contracts - Request flow - Module dependencies - Page vs list detection - Deployment models - Demo fallback Remove outdated plugin system documentation Add new content system documentation Add configuration documentation Add context API documentation Add hooks and plugins documentation Add templates documentation Add rendering documentation Add development environment documentation |
||
|---|---|---|
| app | ||
| devel | ||
| docs | ||
| .gitignore | ||
| AGENT.md | ||
| README.md | ||
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.