stuft2

AGENTS.md

Do

• use Go for all backend logic
• use the standard library first (net/http, html/template, context, database/sql)
• use HTMX for interactivity and progressive enhancement (server-rendered HTML first)
• use Pico.css for styling; extend via custom CSS/SCSS only when needed
• keep handlers small and focused (one responsibility per handler)
• return HTML fragments for HTMX requests and full pages for normal requests
• default to small components/templates

stuft2

Prerequisites

1. Must run in posix terminal
2. Install gh-cli
3. Install jq

Setup

Run gh auth login first, if needed. This implicitly uses your cached token; private repos require a token with repo.

stuft2

Installing Scoped, Internal or Private NPM Packages from GitHub's Package Registry

If you're trying to install a scoped, internal or private library and you run into authentication or not found errors, please continue reading:

Package not found error while installing

Follow the GitHub docs on installing packages from GPR. To install private or internal packages in a GitHub workflow, you'll need to add a GitHub Action Secret to the repository. Organizations that publish packages from multiple repos should provide an organization-level access token and share that token among repos that need to install other internal or private packages within the organization. Organization secrets can be shared with specific repos by an organization admin.

Installing from a single private or internal source

To configure NPM to instal

stuft2

Unit Testing with TypeScript

Setting up Unit Tests with TypeScript is sometimes less than intuitive. My aim here is to present the pros and cons of using Typescript and to detail how simple it is to set up typescript unit tests with Jest and Mocha.

So, Why TypeScript?