README

Minimal starter template for the Larafony Framework. Start with a clean slate and build exactly what you need.

Installation

composer create-project larafony/empty-project my-app
cd my-app

Quick Start

1. Start the Development Server

composer serve

Visit: http://localhost:8000

2. Create Your First Controller

Add controllers in src/Controllers/:

<?php

namespace App\Controllers;

use Larafony\Framework\Routing\Advanced\Attributes\Route;
use Larafony\Framework\Web\Controller;
use Psr\Http\Message\ResponseInterface;

class HelloController extends Controller
{
    #[Route('/hello/{name}', 'GET')]
    public function hello(string $name): ResponseInterface
    {
        return $this->render('hello', ['name' => $name]);
    }
}

3. Create a Blade View

Add views in resources/views/blade/:

<x-layout title="Hello">
    <h1>Hello, {{ $name }}!</h1>
</x-layout>

Project Structure

my-app/
├── bin/larafony           # CLI entry point
├── bootstrap/
│   ├── app.php            # Web application bootstrap
│   └── console.php        # Console application bootstrap
├── config/
│   ├── app.php            # Application config
│   ├── database.php       # Database config
│   ├── logging.php        # Logging config
│   └── views.php          # View engine config
├── public/
│   └── index.php          # Web entry point
├── resources/views/blade/ # Blade templates
├── src/
│   ├── Controllers/       # Your controllers
│   └── View/Components/   # Blade components
└── storage/
    ├── cache/             # Compiled views
    └── logs/              # Application logs

Enabling Database Support

Uncomment the DatabaseServiceProvider in bootstrap/app.php and bootstrap/console.php
Configure your .env file:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=larafony
DB_USERNAME=root
DB_PASSWORD=

Create models in src/Models/

Requirements

PHP 8.5 or higher
Composer

What's Next?

Check out larafony/skeleton for a full-featured demo
Read the documentation at larafony.com

From the Creator

Building a web app? Understand how your users really use it.

Record-it lets you record user sessions and replay them like a video. See clicks, scrolls, form interactions - everything your users do. Find UX issues before they become complaints.

Session recording & replay & mp4 export
Heatmaps & click tracking
Privacy-first (GDPR compliant)

Try it free at record-it.eu | PL: nagraj-to.pl

🚀 Learn How It's Built—From Scratch

Interested in how Larafony is built step by step?

Check out my full PHP 8.5 course, where I explain everything from architecture to implementation — no magic, just clean code.

👉 Get it now at masterphp.eu

Additional Resources

License

The Larafony framework is open-sourced software licensed under the MIT license.

larafony / empty-project

Maintainers

Details