button Add a features section with icons and descriptions Include a stats section with live data Add a responsive design with modern CSS features
45 lines
2 KiB
Markdown
45 lines
2 KiB
Markdown
<!-- The hero.php file renders above this markdown content -->
|
||
<!-- Files are combined in alphabetical order: hero.php, then index.md -->
|
||
|
||
## Quick Start
|
||
|
||
1. **Empty the content folder** – Delete everything in `/content/` to start fresh
|
||
2. **Copy the default folder** – Copy `/app/default/` to `/custom/` (one level up from app/) to create your own theme
|
||
3. **Add your content** – Drop `.md`, `.html`, or `.php` files in `/content/` and they're live
|
||
4. **Customize templates** – Edit files in `/custom/templates/` to change the look
|
||
5. **Style it** – Add CSS in `/custom/styles/styles.css` for global styles
|
||
|
||
## What Makes FolderWeb Different
|
||
|
||
**File-based routing** – Your folder structure is your URL structure. No configuration needed.
|
||
|
||
**No JavaScript** – Fast, simple, accessible websites that work everywhere.
|
||
|
||
**Modern PHP & CSS** – Clean code using the latest language features and CSS capabilities.
|
||
|
||
**No build step** – Edit a file, refresh the page. That's it.
|
||
|
||
**Decade-proof** – Minimal dependencies mean this will work for years without breaking.
|
||
|
||
## How This Page Works
|
||
|
||
This frontpage demonstrates how you can **mix different file types** to create dynamic, custom layouts:
|
||
|
||
- **`hero.php`** – Dynamic PHP component with live stats and styling
|
||
- **`index.md`** – Static markdown content (this section!)
|
||
|
||
Files in the same directory are rendered alphabetically. Want a different order? Prefix filenames with numbers like `00-hero.php` and `01-content.md`.
|
||
|
||
## Features Demonstrated Here {#features}
|
||
|
||
Explore this demo site to see what FolderWeb can do:
|
||
|
||
- [Examples](/examples/) – Markdown, metadata, dates, and cover images
|
||
- [Multilingual](/multilingual/) – Build sites in multiple languages
|
||
- [Nested Content](/examples/nested/) – Organize content as deep as you need
|
||
|
||
## Philosophy
|
||
|
||
**Just enough, nothing more.** This framework uses minimal PHP to enable modern conveniences while remaining maintainable for years or decades.
|
||
|
||
Read more in `CLAUDE.md` to understand the principles behind FolderWeb.
|