happytodev/cyclone

A simple blog system for TempestPHP framework

v1.0.0-alpha.28 2025-07-05 14:45 UTC

Requires

• league/commonmark: ^2.7
• spatie/yaml-front-matter: ^2.1
• symfony/yaml: ^7.2
• tempest/core: *
• tempest/framework: ^1.0
• tempest/highlight: ^2.11

MIT

• Fred Blanc

README

Cyclone is the first blog engine made with Tempest framework.

How to install Cyclone?

It's very easy.

First, you need to create a folder for your project:

mkdir cyclone-demo
cd cyclone-demo

Next, as Cyclone is in alpha, you have to set a minimal composer.json to start. So edit your composer.json with your favorite editor (for example nano composer.json) and add this content:

{
    "minimum-stability": "dev",
    "prefer-stable": true
}

Next,

composer require happytodev/cyclone

When composer is done, lauch the installer:

./vendor/bin/tempest cyclone:install

At the end of install, if everything is ok, you can launch your server and go to your new blog:

https://cyclone-demo.test

Last point, set the url of your project in the .env file.

nano .env 

And set the BASE_URI variable with your url.

...
# The base URI that's used for all generated URIs
BASE_URI=https://cyclone-demo.test
...

And voilà!

How to add content in Cyclone?

Just by adding some markdown files in the content/blog folder.

Roadmap

A lot of work to do, but the main points are:

• Add a login page
• Add a dashboard
• Add a way to add content
• Add a way to edit content
• Add a way to delete content
• Add pages (CMS part)
• Add categories
• Add tags
• Add comments
• Add a search engine
• Add a way to add a custom theme
• Add a way to add a custom plugin
• etc...

License

The MIT License (MIT). Please see License File for more information.

Contributing

Please see CONTRIBUTING for details.

Security

Vulnerabilities should be reported to [e-mail]. Please see SECURITY for more information.

Credits

• Frédéric Blanc
• All Contributors