This repository is the public website for the Thoughtful AI Tools Lab
(https://thoughtful-ai.com). The research application itself lives in a separate
repo: AIToolsLab/writing-tools.
Changes here are about how the lab presents its people, projects, vision, and
publications — not the writing tool's behavior.
- Requires Node.js 18+ and npm.
npm install— install dependencies.npm run dev— local dev server at http://localhost:4321.npm run build— production build intodist/. CI runs this on every PR; if it fails, the PR can't merge, so run it locally before pushing.
| You want to change... | Edit... |
|---|---|
| A team member (add yourself, mark graduated) | a JSON file in src/data/people/ — see that folder's README.md |
| Publications | the publications array in src/pages/publications.astro |
| Projects | src/pages/projects.astro and the per-project pages in src/pages/projects/ |
| The lab's vision statement | src/pages/vision.md |
| Site-wide header/footer/nav | src/components/lab/ |
Page shell, <head>, SEO tags |
src/layouts/Layout.astro |
See src/data/people/README.md. Short version: add
your photo to public/people/, copy _example.json to your_name.json, fill it
in, and open a PR. One file per person means no merge conflicts when several
people add themselves at once.
- Styling is Tailwind CSS utility classes. Match the classes already used on nearby elements rather than introducing new CSS.
- Pages are Astro (
.astro); interactive UI is React (.tsx) undersrc/components/. - Keep content data-driven where a pattern exists (e.g. the people JSON files) so future contributors edit data, not markup.
The site is deployed on Cloudflare (see wrangler.jsonc), serving the built
dist/ directory. You don't need to deploy manually — merging to main is enough.