This site is built with Viewi itself. It is experimental and still in development. If you see any bugs please do not hesitate and open an issue or DM me on Twitter.


Install The Viewi Package

> composer require viewi/viewi:dev-master

Create a new app with Viewi CLI tool

To create a default viewi application automatically run command:

> vendor/bin/viewi new [folder]

Where folder is an optional parameter and can be omitted. For example:

> vendor/bin/viewi new
> vendor/bin/viewi new myViewiApp
> vendor/bin/viewi new src/ViewiApp

It will generate for you the default code for using Viewi as a standalone application in one of these files: /index.php or /public/index.php.

If you specified folder parameter, your components will be located in that folder, otherwise it will use one of these: viewi-app/ or src/ViewiApp/.

Create a new app manually

To create a new app manually follow the next steps

Include vendor autoload

In your /public/index.php put this if it's not there already:

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

Create folders for your components

Like this:
  • viewi-app/
  • viewi-app/build for compiled server-side components
  • viewi-app/Components for your front-end application (templates, services, models)
You can chose your own folder instead of viewi-app/.

Create the next files

Config file viewi-app/config.php:


use Viewi\PageEngine;

const VIEWI_COMPONENTS = __DIR__ . '/Components';
const PUBLIC_FOLDER = __DIR__ . '/../public/';

return [
    PageEngine::SERVER_BUILD_DIR =>  __DIR__ . '/build',
    PageEngine::DEV_MODE => true,
    PageEngine::RETURN_OUTPUT => true,
    PageEngine::COMBINE_JS => true

Routes file viewi-app/routes.php:


use Viewi\Routing\Route as ViewiRoute;

// routes here

Viewi boot file viewi-app/viewi.php:


use Viewi\App;

$config = require 'config.php';
include __DIR__ . '/routes.php';

Include Viewi boot file

In your /public/index.php put these:

include __DIR__ . '/../viewi-app/viewi.php';

Now you are ready to create your first component