README

Una visión minimalista hacia el futuro del desarrollo web

PicoFrame es un micro-framework ligero construido en PHP, con soporte para Twig y una pizca de JavaScript y SCSS.
Optimizado para soltar código innecesario, potenciar la eficiencia y preguntarse:
¿por qué complicar lo simple?

🚀 Instalación

Opción 1: Instalar con Composer (recomendado)

composer require tenor/picoframe

Opción 2: Crear un nuevo proyecto

composer create-project tenor/picoframe nombre-de-tu-proyecto
cd nombre-de-tu-proyecto

Copia el archivo .env.example a .env y ajusta las variables según tu entorno.

cp .env.example .env

Instala dependencias y compila assets:

composer install
npm install
npm run build

Ejecuta el servidor embebido de PHP:

php pico serve

Accede en tu navegador a http://localhost:8000.

Comndo lista

php pico

📖 Ejemplo rápido

Controlador básico

<?php

require __DIR__ . '/../vendor/autoload.php';

use PicoFrame\App;

$app = new App();

$app->get('/', function () {
    return $this->render('home.twig', [
        'titulo' => 'Bienvenido a PicoFrame',
        'mensaje' => 'Framework minimalista, simple y veloz 🚀'
    ]);
});

$app->run();

home.twig

<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="UTF-8">
<title>{{ titulo }}</title>
</head>
<body>
  <h1>{{ mensaje }}</h1>
</body>
</html>

🛠️ Tecnologías usadas

PHP (~78 %)
Twig (~16 %)
Hack (~3 %)
JavaScript (~2 %)
SCSS (~0.4 %)

📚 Documentación del Framework

🔹 Rutas

$app->get('/hola/{nombre}', function ($nombre) {
    return $this->render('saludo.twig', [
        'nom' => $nombre
    ]);
});

saludo.twig

<h2>Hola, {{ nom }}. ¿Y ahora qué?</h2>

🔹 Motor de Plantillas

Usa Twig para procesar vistas.
render($vista, array $datos) busca la plantilla en resources/views/.

🔹 Configuración

.env permite definir parámetros como APP_ENV, DB_HOST, etc.
Helper sugerido: config('VARIABLE').

🔹 Assets

public/ contiene archivos compilados de SCSS y JS con npm run build.

🗺️ Roadmap Futuro

Funcionalidad	Estado
Middleware	En diseño
CLI integrada	Planeado
Cache Twig	Planeado
ORM minimal	En exploración
Tests con Pest	Planeado

🤝 Cómo contribuir

Haz un fork.
Crea tu rama: git checkout -b feature/tu-idea-genial.
Haz commits cortos y claros 😉.
Envía un pull request.

📜 Licencia

Este proyecto usa licencia MIT: haz con él lo que quieras… pero con respeto.

✨ Resumen

PicoFrame es tu lienzo en blanco en PHP: limpio, elegante, con Twig integrado y un stack ligero.
Un framework hecho para no complicar lo simple y abrir paso a un futuro donde la simplicidad manda.

picoframe / picoframe

Maintainers

Details