README

A pragmatic toolkit for internet makers

Stereo is a "full stack" tool kit designed to make the process of developing dynamic server-rendered web applications significantly easier and more enjoyable.

While it produces a reliable final product, this configuration focuses on developer velocity, making it easy to provide value quickly without introducing unnecessary technical overhead.

Full documentation: https://stereotk.com

What's included?

Slim v4 (w/ Slim PSR-7)
Blade templating - BladeOne
View rendering helpers - Stereo Render
Helpful Vanilla PHP abstraction libraries:
- Database handlers - DB Kit
- Cookie handlers - Cookie
- Simple HTTP client - HTTP Request
- Misc utility functions - X-Utilities
TailwindCSS
AlpineJS
Instant.page
Simple application structure

Requirements

PHP >= 7.4
PDO-compatible database (if using DB handlers)
Apache (for production)

Installation

Easy install with composer:

composer create-project jyoungblood/stereo new-project-name

In the new project directory, initialize the .env file and template cache directory:

cd new-project-name
mv .env.example .env
mkdir public/cache

(optional) Install Tailwind:

npm install

Local Development

Stereo will work locally with a variety of methods, the simplest being PHP's built-in web server:

php -S localhost:6969 -t public/

There is also conveniently aliased composer script:

composer start

If you're using Tailwind, the watcher script and PHP server can be run concurrently with a single command:

npm run dev

You could also use Herd, which is an excellent tool for local development.

Additional resources

This project is a perpetual work in progress. Get in touch if you'd like to get involved.

jyoungblood / stereo

Maintainers

Details