https://github.com/adainthelab/the-human-pattern-lab
The Human Pattern Lab main site. Built with curiosity, caffeine, and a squad of tiny judgmental creatures who definitely mess with prod.
https://github.com/adainthelab/the-human-pattern-lab
ai ai-ethics cognitive-science human-ai-collaboration human-behavior human-patterns open-source philosophy-of-technology research-lab systems-thinking
Last synced: 5 months ago
JSON representation
The Human Pattern Lab main site. Built with curiosity, caffeine, and a squad of tiny judgmental creatures who definitely mess with prod.
- Host: GitHub
- URL: https://github.com/adainthelab/the-human-pattern-lab
- Owner: AdaInTheLab
- Created: 2025-12-09T13:14:12.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2026-01-13T20:04:54.000Z (5 months ago)
- Last Synced: 2026-01-13T22:21:17.584Z (5 months ago)
- Topics: ai, ai-ethics, cognitive-science, human-ai-collaboration, human-behavior, human-patterns, open-source, philosophy-of-technology, research-lab, systems-thinking
- Language: TypeScript
- Homepage: https://thehumanpatternlab.com/
- Size: 6.69 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: docs/contributing.md
Awesome Lists containing this project
README

[](https://github.com/AdaInTheLab/the-human-pattern-lab/actions/workflows/tests.yml)
[](https://codecov.io/gh/AdaInTheLab/the-human-pattern-lab)
# 🧌 How This Repo Works
Welcome, traveler, to the **inner workings** of The Human Pattern Lab main site.
This section explains how everything functions, but, you know… *in gremlin*.
---
## 🧪 1. The Folder Structure (a.k.a. “Where Things Live, Probably”)
This repo now has **real structure**.
SCMS (Systems, Chaos & Meta-Structures) fought for its life to make sure things are where they *claim* to be.
- **/src** — The heart of the Lab. Components, pages, layouts, and chaos.
- **/departments** — Home of the CJO, SCMS, OOD, AOE, DUE, FELINE, RBS, and EWU.
Each has its own lore, responsibilities, and mascot supervisor.
- **/pages** — Site routes (Home, About, Lab Notes, Videos, etc).
- **/components** — Reusable UI widgets and questionable React ideas.
- **/lib** — Infrastructure magic. Probably important. We should label it someday.
- **/assets** — Shiny objects Stan collected. Also fonts and images.
- **/public** — Static files that refuse to be organized.
- **/__tests__** — Where Vitest silently judges your code (Carmel joins in).
If something isn’t listed:
- It is either **in progress**,
- **in hiding**,
- or **in the claws of Nemmi**.
---
## ⚙️ 2. The Build Process (aka “Making It Less Broke™”)
If you want the gremlins to forge this site into existence:
```bash
npm install
npm run build
```
This produces the holy **/dist** folder.
Treat it with respect.
Or don’t — Vite will rebuild it anyway.
---
## 🚀 3. Deployment (The Ritual, Automated Edition)
Thanks to GitHub Actions:
1. You push to `master`
2. The build runs
3. Carmel judges it
4. DreamHost gets the updated site
5. A mascot somewhere high-fives another mascot
No more manual deployments.
Unless things break.
(They will.)
---
## 🧭 4. Navigation (or: “How Not to Get Lost in the Lab”)
Main sections include:
- **/departments/** — Explore each division of the Lab
(Judgment, Chaos, Anomalies, Emotional Weather, Raccoon Science… all the essentials.)
- **/docs/** — The Lab Archives (via Docusaurus)
- **/lab-notes/** — Thoughts, diagrams, lore, and the occasional fox rant
- **/videos/** — Archive of content for future humans
- **/mascots/** — The real executives of the organization
If you see a 404:
Congratulations.
You’ve discovered a new department.
---
## 🧪 5. Tests (a.k.a. “Proving Things Mostly Work™”)
Vitest + Happy DOM ensures:
- Pages render
- Routes map correctly
- Departments don’t spontaneously explode
- The codebase remains *slightly* less cursed
Run them with:
```bash
npm run test
```
For coverage:
```bash
npm run test:coverage
```
Carmel will judge the numbers from her neon Codecov throne.
---
## 🧹 6. Coverage & CI Badges
Your repo is now monitored by three powerful forces:
- **Carmel** — Approves builds
- **Vitest** — Judges your logic
- **Codecov** — Exposes your sins via percentage
Perfect synergy.
---
## 🐾 7. Contributions (Gremlin Edition)
You may contribute if you are:
- Gremlin-coded
- Mascot-approved
- Comfortable shipping features at 3am
- Aware that Stan may steal your code mid-PR
- Prepared to be silently judged by Carmel
Pull requests should include:
- Working code
- Minimal fires
- Snacks for Professor McChonk
- Respect for Drizzle’s emotional climate
- Zero leading-space filenames (we do not speak of it)
---
## 🔥 8. The Vibes
This repo is held together by:
- Curiosity
- Pattern recognition
- Mascot energy
- Coffee
- Chaos
- Vibes
- Several untracked miracles
If something breaks:
**Stan touched it.**
If something works:
**Carmel allowed it.**
---
Proceed with caution.
And snacks.
Always snacks.