
Please raise an Issue if you would like to feedback or assist.
Air::Play
Playing with the hArc stack (HTMX, Air, Red, Cro) - https://harcstack.org. Some website with Pico CSS styling.
Local
GETTING STARTED
Install raku - eg. from rakubrew, then:
Install Air, Cro & Red
Install this repo
git clone https://github.com/librasteve/Air-Play.git
cd Air-Play
&& zef install .
Run and view it
export WEBSITE_HOST="0.0.0.0" && export WEBSITE_PORT="3000"
raku -Ilib service.raku
- Open a browser and go to
http://localhost:3000
Select the example site you want by commenting out the others in the Play.rakumod
file.
You will note that cro has many other options as documented at Cro if you want to deploy to a production server.
Server
Development
Pico CSS (IntelliJ)
install sass (in the static/css dir)
- follow this guide
- install IJ sass & file watcher plugins
cd static/css
brew install npm
npm install -g sass
npm install @picocss/pico
- in styles.css,
@use "node_modules/@picocss/pico/scss";
sass styles.scss styles.css
[target is then styles.scss/styles]--load-path=node_modules/@picocss/pico/scss/
from https://picocss.org
- some tweaks to root styles (mainly to reduce scale) from here
Deployment
- Install Air, Cro & Red (see above)
git clone https://github.com/librasteve/Air-Play.git && cd Air-Play
zef install . --force-install --/test
- adjust .cro.yml for your needs (e.g. HTTPS) -or-
export WEBSITE_HOST="0.0.0.0" && export WEBSITE_PORT="3000"
raku -Ilib service.raku
-or-nohup raku service.raku >> server.log 2>&1
<=== detach from terminal [note PID]tail -f server.log
and finally kill -9 PID
[ps -ef | grep raku]
Build
this site runs on a linux server preloaded with git, raku, zef (& docker-compose) which can be set up with raku CLI::AWS::EC2-Simple
COPYRIGHT AND LICENSE
Copyright(c) 2025 Henley Cloud Consulting Ltd.
This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.