switon/skeleton

Official starter application for Switon Framework

v1.0.0 2026-06-06 13:43 UTC

Requires

• php: >=8.3
• ext-json: *
• psr/container: ^2.0
• psr/event-dispatcher: 1.0.*
• psr/log: ^2.0
• psr/simple-cache: ^3.0
• switon/authz: ^1.0
• switon/cache: ^1.0
• switon/cli: ^1.0
• switon/composer-extra: ^1.0
• switon/context: ^1.0
• switon/core: ^1.0
• switon/event: ^1.0
• switon/http: ^1.0
• switon/id: ^1.0
• switon/kernel: ^1.0
• switon/log: ^1.0
• switon/principal: ^1.0

Requires (Dev)

• switon/testing: ^1.0

Suggests

• switon/beacon: Optional Beacon CLI tooling (composer require switon/beacon --dev)

MIT

• switon

• boilerplate
• application
• app
• starter
• switon

README

Official starter for a new Switon application.

Installation

composer create-project switon/skeleton my-app
cd my-app

Run

php public/index.php

create-project creates .env from .env.example and generates MASTER_KEY. .env defaults SERVER_TYPE=php for the built-in PHP server.

Then open:

• http://127.0.0.1:9501/ — welcome JSON
• http://127.0.0.1:9501/time/current — sample route

CLI

bash bin/console tool:list
bash bin/console router:list --json

On Windows when shell wrapper execution is unavailable, use php switon.php instead of bash bin/console.

Start Here

• switon.yml defines app metadata, route prefixes, server options, and default filters.
• app/Controller/ contains the example controllers.
• add config/*.php only when you need PHP-only configuration patches.
• public/index.php is the HTTP entrypoint.

Docs: https://docs.switon.dev/latest/tutorial