Skip to content

jyoungblood/stereo

Repository files navigation

STEREO

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/docs

What's included?

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.