icom/ framework

A clear starting point.

Download the source, install the locked dependencies, and run your first application.

Requirements

PHP 8.4 or 8.5, Composer 2, JSON, mbstring, PDO, Sodium, and a PDO driver. The source archive contains the complete framework, demo application, tests, prompt and deployment examples. It excludes credentials, local data and vendor packages. This preview is distributed here; it is not published on Packagist.

Run locally

example / terminal
curl -fLO https://framework.icom.la/downloads/icom-framework-0.1.0.zip
curl -fLO https://framework.icom.la/downloads/icom-framework-0.1.0.zip.sha256
sha256sum -c icom-framework-0.1.0.zip.sha256
unzip icom-framework-0.1.0.zip
cd icom-framework
composer install
cp .env.example .env
php bin/icom key:generate
php bin/icom migrate
php -S localhost:8080 -t public bin/serve.php

Project anatomy

example / terminal
app/              Your controllers
routes/web.php    Explicit route registration
src/              Framework modules
resources/views/  Escaped PHP templates
public/           The only web-accessible directory
storage/          Private database, cache and logs
config/           Application configuration extensions
tests/run.php     Regression suite
bin/icom          CLI tools
deploy/           Runtime and infrastructure examples

Configure before production

Set APP_ENV=production, APP_DEBUG=false, APP_URL to your HTTPS origin, and APP_HOSTS to a comma-separated host allowlist. Generate a unique APP_KEY for each installation. Only public/ belongs in the document root. Never put .env, storage, tests or vendor in a public directory. Shell environment variables override .env.

ສຳລັບນັກພັດທະນາລາວ

ICOM Framework ລຸ່ນ 0.1 ເປັນ developer preview. ທ່ານສາມາດດາວໂຫຼດ source code, ອ່ານ prompt ແລະທົດລອງ API ຈິງໄດ້. ຍັງບໍ່ມີຫຼັກຖານວ່າໄວກວ່າ Laravel ຫຼື Symfony.

Developer preview — benchmark claims require reproducible evidence.

Explore the architecture