This file provides guidance to coding agents when working with code in this repository.
This repo is the GitHub Pages site for https://silvercode.studio. Silvercode Studio is the umbrella organization for Preston's open-source apps. The site presents those projects.
The site is plain static HTML and CSS at the repo root, with no generator or framework. Do not add one (for example, Jekyll) unless asked.
index.htmlis the home page. It lists the apps as cards.sponsor.htmllists the ways to tip, one card each. The apps link to it ashttps://silvercode.studio/sponsor(GitHub Pages servessponsor.htmlthere), so keep that address working. Links inside the site usesponsor.html, becausemake siteandmake lintdo not know the short form. A way to tip that is not ready yet shows a "Coming soon" chip, and an HTML comment in its card holds the button to add.- Every page has the same nav and footer, written out in each file. When you change one, change all pages.
css/tokens.cssandcss/site.cssstarted as copies of Silverside's (../Silverside/docs/site/css), so the studio and the apps share one look.site.cssno longer has Silverside's HDCD and DTS rules. When you change a shared rule, consider the same change in Silverside's copy. The studio's own rules go incss/studio.css, not insite.css.js/site.jsis the theme part and the phone-menu part of Silverside'sjs/site.js. It shows the theme buttons, setsdata-themeon<html>, and keeps a choice inlocalStorageonly while it differs from the system appearance. A short script in<head>applies the stored choice before the page draws. Without JavaScript, the page follows the system appearance.- Images:
images/icon.pngis the studio icon, andimages/apple-touch-icon.pngis the same picture.images/silverbox.pngandimages/silverplay.pngare the full-size app icons; the studio uses the Silverbox floppy disk as its own icon. The pages show 256 px copies (silverbox-256.png,silverplay-256.png, made withsips -Z 256 in.png --out out.png), as the full-size files are up to 2 MB. When an app icon changes, make its copy again. .editorconfigsets the style: LF line ends, a final newline, no spaces at line ends, and 2-space indents in HTML, CSS, and YAML.
make siteserves the repo root athttp://localhost:8000. Silverside'smake sitealso uses port 8000; setPORT=8001to run both.make lintreports broken local links in*.html(scripts/check-links.pl) and spaces or tabs at line ends.make buildcopies the published files (SITE_FILESin theMakefile) to_site/.
.github/workflows/pages.yml runs make lint and make build on each push to main, then deploys _site/ to GitHub Pages. A broken link stops the deploy. Only the files in SITE_FILES are published, so README.md, AGENTS.md, Makefile, and scripts/ stay off the site. When you add a new top-level page or folder, *.html already covers pages; add a new folder to SITE_FILES.
Because the workflow publishes the site, GitHub does not run Jekyll, and no .nojekyll file is needed. The custom domain is set in the repo's Settings › Pages; the workflow ignores CNAME, but it stays as a record of the domain.