codeandClaude Sonnet 5
f2724972af
Sidecar-less page bundles whose directory ends in a MediaType extension
(.txt/.css/.xml/.json/.js) now render raw (no HTML layout, autoescape off),
are served with that extension's Content-Type, and cache as a flat file
(public/cache/<path>) so Apache serves them directly via a new .htaccess
rule. They're excluded from the content index.
CSS becomes one of these: novaconium/pages/css/main.css/ holds index.twig
({{ sass('main.sass') }}), main.sass, and _colors.sass. App\SassExtension's
sass() Twig function resolves the entry file through the overlay and shells
out to Dart Sass on a cache miss; Lib\SassCompiler wraps the CLI. This
drops the committed App/css/main.css build artifact and the public/css
bind mount. Override styling by copying the whole bundle to App/pages/.
Also ship robots.txt and humans.txt as framework bundles, and drop the
php -S dev router (public/router.php) - Docker/Apache only now.
New: novaconium/src/MediaType.php, SassExtension.php, lib/SassCompiler.php.
Moved: novaconium/sass/ -> novaconium/pages/css/main.css/ (+ App/sass merged).
Docs: AGENTS.md, new /admin/docs/text-pages, and styling/caching/docker/
design-notes/getting-started/project-layout/config docs updated.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Q9cAXC9xcXYnmP7qjsnw7
A Hugo-flavored PHP framework. Routes are directories on disk, pages render with Twig, and any page that needs real logic gets an optional PHP "sidecar" file. Pages without a sidecar are pre-rendered once and served as static HTML straight from Apache afterwards.
For a full tour of what's included — routing, sidecars, caching, admin auth, access control, media manager, database, search, RSS, and more — see the Novaconium docs.
This project is currently in beta testing. The issue tracker is at https://git.4lt.ca/4lt/novaconium/issues — email nova@4lt.ca for a login.
Getting started
Webmasters
PROJECTDIR="${PROJECTDIR:-/data}"
mkdir -p "$PROJECTDIR"/novaconium/{cache,uploads,data}
docker pull git.4lt.ca/4lt/novaconium:2.0.0-beta
docker run -d \
--name novaconium \
-p 8080:80 \
-v "$(pwd)/$PROJECTDIR"/novaconium/App:/var/www/html/App \
-v "$(pwd)/$PROJECTDIR"/novaconium/cache:/var/www/html/public/cache \
-v "$(pwd)/$PROJECTDIR"/novaconium/uploads:/var/www/html/public/uploads \
-v "$(pwd)/$PROJECTDIR"/novaconium/data:/var/www/html/data \
git.4lt.ca/4lt/novaconium:2.0.0-beta
You should also add a favicon.ico to your PROJECTDIR.
You can find example PROJECTDIR files and directory structure in: https://git.4lt.ca/4lt/novaconium/src/branch/v2/App
$PROJECTDIR/novaconium/data is for your sqlite database and will be created from scratch when running novaconium.
Open http://localhost:8080/ in your browser.
Developers
docker buildx build --no-cache -t git.4lt.ca/4lt/novaconium:2.0.0-beta --load .
docker login git.4lt.ca -u <username>
docker push git.4lt.ca/4lt/novaconium:2.0.0-beta
docker compose up -d
Create A User
docker exec -it novaconium php novaconium/bin/create-admin-user.php <username> <email>
Third-party
Twig is vendored in source form under novaconium/vendor/twig/ (no Composer — see /admin/docs/upgrading-twig for how to upgrade it). It's BSD-3-Clause licensed; the full license text ships alongside it at novaconium/vendor/twig/LICENSE.