Skip to content

sebkolind/volcano

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Volcano ๐ŸŒ‹

A micro flat-file blog and website constructor.

Features

  • No database
  • Fast
  • Easy to use
  • You write your content in beautiful Markdown
  • Great with custom designs

Requirements

Getting Started

cd ~/path/to/project

composer require sebastianks/volcano

# IMPORTANT
# Copy a slim starter template bundled with Volcano.
cp -r vendor/sebastianks/volcano/setup/* .

Volcano will now serve your app from /site/theme/index.php which at it's lightest can be as slim as:

<?php

# Get our App instance
$app = require __DIR__ . '/../../app.php';

# This is where the magic happens ๐Ÿง™โ€โ™‚๏ธ
echo $app->render();

That is Volcano at it's barebones. A more realistic real-life example can be found in the Wiki.

What's next?

You just created your first app with Volcano๐ŸŽ‰ Now you can go ahead and make a beautiful theme, start composing some content or something else you fancy. It's all up to you.

A couple of resources if you need some information and/or inspiration:

  • Read the Wiki. It's short and will get you started in no time.
  • Volcano has a well-documented codebase. Reading it will give you everything there is to know about Volcano.
  • Creating a blog? Try out the official Blog template and start blogging right away.