marko/skeleton

The official application template for starting new Marko Framework projects. This is a composer create-project template that scaffolds a ready-to-use project structure with the entry point, directory layout, environment config, and dev tooling pre-configured.

Installation

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

Project Structure

my-app/
├── app/                # Your application modules
├── config/             # Root configuration overrides
├── modules/            # Third-party modules
├── public/
│   └── index.php       # Web entry point
├── storage/            # Logs, cache, sessions
├── tests/
├── .env.example        # Environment variable template
└── composer.json

Entry Point

The public/index.php bootstraps the application:

<?php

declare(strict_types=1);

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

use Marko\Core\Application;

$app = Application::boot(dirname(__DIR__));
$app->handleRequest();

Application::boot() discovers modules, registers bindings, and builds the DI container. handleRequest() routes the incoming HTTP request to the matched controller.

Getting Started

1. Copy the environment template:

cp .env.example .env

2. Start the dev server:

marko up

3. Visit http://localhost:8000

Included Dependencies

Package	Description
marko/framework	Metapackage bundling core, routing, CLI, errors, config, hashing, validation
marko/env	Environment variable loading with env() helper

Dev Dependencies

Package	Description
marko/dev-server	marko up / marko down development environment
pestphp/pest	Testing framework

Environment Configuration

The .env.example ships with:

APP_ENV=local
APP_DEBUG=true

See the Configuration guide for adding database, cache, and other environment variables.

Next Steps

• Your First Application — Create your first route and controller
• Project Structure — Understand the directory layout in depth
• Create a Custom Module — Build a reusable module inside app/
• marko/framework — See all optional packages you can add

Requirements

• PHP 8.5 or higher