From zef to first request.

#1. install with zef

MVC::Keayl is distributed through Raku's package manager, zef. Don't have Raku yet? Grab it from rakudo.org; zef ships with every install.

That installs the module and puts the keayl CLI on your PATH. Verify:

$ keayl version
MVC::Keayl 0.9.0

#2. scaffold an application

keayl new writes a runnable skeleton: the config/ (a layered application.json, an application.raku that returns the MVC::Keayl::Application, a routes.raku with a root route, and encrypted credentials), a HomeController with its view and layout, static exception pages under public/, an assets/ tree, a starter spec, a META6.json, and bin/dev, bin/server, and bin/test scripts.

#3. draw a route, write an action

A request needs three pieces: a route that names the target, a controller with the action, and a view for it to render.

use MVC::Keayl::Routing;

routes {
  root to => 'home#index';
  resources 'articles';
}

use MVC::Keayl::Controller;

class ArticlesController is MVC::Keayl::Controller {
  method index {
    self.assign('articles', Article.all);
  }
}

%h1 Articles

%ul
  != partial-each('articles/row', $articles)

%li= $row.title

#4. run it

keayl server loads config/application.raku, builds the Cro endpoint, and listens. The host defaults to 127.0.0.1 and the port to 3000.

#the keayl CLI

#environments and config

MVC::Keayl::Config reads a JSON file, the same config/application.json shared with ORM::ActiveRecord, merging a shared section under the selected environment. The environment comes from KEAYL_ENV, then RAKU_ENV, defaulting to development.

{
  "shared": { "app-name": "Blog" },
  "development": {
    "database": { "adapter": "sqlite" },
    "log-level": "debug"
  },
  "production": { "log-level": "error" }
}

#where to go next