README

Simple. Layered. Harmony in MVC and HMVC.

Site: https://nsyframework.com/ · Docs: OVERVIEW · Libraries · Load & Asset · Helpers · Router · Migration · Model

Codename

Current Release Codename: Gamelan
Inspired by the traditional Indonesian ensemble, Gamelan represents harmony, modularity, and synchronized execution. Just as each instrument in a Gamelan orchestra plays a precise role to create a rich rhythm, NSY brings together lightweight core components and flexible modules (HMVC) into a unified, harmonious workflow.
(Note: Codename evolves with major version releases to honor Indonesian cultural heritage).

Features

• MVC & HMVC with Razr templates
• PSR-4 Autoloading + NSY CLI (nsy make:*, nsy run:migrate)
• Asset Manager (Add::link/script/meta) with ?v=filemtime cache-busting
• Unified DB (NSY_DB::connect) + powerful Migrations (DRY, quoted identifiers)

Requirements

• PHP >= 8.1, Composer, MySQL/MariaDB/PostgreSQL/SQL Server (optional)

Quick Start

composer create-project kazuyamarino/nsy my-app
cd my-app
cp docs/env.example/env.example.php env.php
composer dump-autoload -o
nsy --setup

Configuration

• env.php — APP_ENV, PUBLIC_DIR, SITE_TITLE, CSRF_TOKEN, DB_* (see docs/env.example/env.example.php)
• System/Config/App.php & Site.php — env-aware with config_env() ?? fallback (no file edit in production)
• System/Config/Mimes.php — 182 mime types (modern: webp, avif, woff2, wasm)

Documentation

• Overview — Composer, Config, Helpers, Routes, MVC/HMVC, Assets, PSR-4, CLI
• Deploy to Shared Hosting — System/ outside public_html, writable dirs, mod_rewrite/AllowOverride
• Libraries — File, LanguageCode, LoadTime, Request, Validate
• Load & Asset Manager — Load::view/template/model & Add:: (?v=filemtime)
• Helpers Global — base_url(), is_filled(), css_url() etc.
• CodeIgniter Helpers — stringify_attributes(), directory_map() etc.
• Router — Route::get/post/group, middleware
• Security Middleware — CSRF, XSS, rate-limit
• Migration — Mig::createTable(), quoteIdent/execDDL (DRY)
• Model & DB — DB::query(), NSY_DB::connect() unified
• Query Builder — qb('users')->whereIn()->paginate() — minimal lines

License

MIT — see LICENSE.txt