Directory of queer/trans groups, venues and spaces in Omaha.
- *nix
- Bun as drop-in Node interpreter replacement, package manager and test runner
- (optional) volta for node ver wrangling
- (optional) Netlify CLI for managing live deployments
- Astro for static site generation and light SSE
- Biome for lint
- Playwright for mobile and desktop browser testing
- vitest for unit tests
# install dependencies
bun install --development
# astro w/ HMR at localhost:4321
bun run dev
The Netlify GitHub app is installed for this repo, which creates a "preview deployment" on (non-draft) Pull Requests.
Merges to main (protected branch) will deploy the production site.
# install netlify CLI globally
bun install -g netlify-cli
# authenticate
netlify login
# link repo with Netlify project
netlify link
# create a test deployment
netlify deploy
# after validation, deploy production
netlify deploy --production
Pull Requests must pass lint and include relevant unit/end-to-end tests.
Accessibility for motion-sensitivity, color, fonts, reduced scrolling, tapping affordances, "go to top" are table stakes.
This project uses Husky hooks which you can install locally to automatically lint and test on pre-commit and pre-push.
bunx husky init
You can run lint (via biome) manually
bun run lint # check formatting
bun run format # auto-fix formatting
You must add/update unit tests for code changes.
End-to-end tests are strongly recommended for commits that touch the frontend.
bun run test:unit # vitest
bun run test:e2e # Playwright mobile/ desktop browsers
bun run test:a11y # Accessibility via axe
bun run test:lighthouse # Lighthouse audit (SEO, perf)