# Getting Started

## Requirements

- PHP 8.4+
- Apache with mod_rewrite
- A text editor

## Installation

```bash
git clone https://github.com/yourusername/folderweb.git
cd folderweb
cp -r app/default custom
mkdir content
```

## Local Development

```bash
cd devel
podman-compose up -d
```

Or with PHP's built-in server:

```bash
php -S localhost:8080 -t .
```

Visit `http://localhost:8080`.

## Your First Page

Create `content/hello.md`:

```markdown
# Hello, World!

This is my first page.
```

Visit `http://localhost:8080/hello/`.

## Deploying to Shared Hosting

### Recommended Structure

Keep the framework and content outside the web root. Use symlinks to expose them:

```
/home/username/
├── folderweb/           # Git repo (not public)
│   ├── app/
│   └── custom/
├── content/             # Your content (not public)
└── public_html/         # Web root
    ├── app -> ../folderweb/app/
    ├── custom -> ../folderweb/custom/
    └── content -> ../content/
```

To update FolderWeb, `git pull` in the repo directory.

### Apache

FolderWeb includes an `.htaccess` file that handles routing automatically. If your host requires manual configuration:

```apache
<Directory /path/to/public_html>
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^(.*)$ /app/router.php [L,QSA]
</Directory>
```

## Next Steps

- [Adding content](../02-tutorial/01-adding-content.md) — Pages, metadata, and content formats
- [Styling](../02-tutorial/02-styling.md) — Customize the look
- [Templates](../02-tutorial/03-templates.md) — Control how content is presented