The public-facing site for Stanford Medicine's AI in Medical Education initiative, which integrates foundational AI knowledge, clinical applications, and ethical reasoning into medical education.
Live site: https://stanfordmed.github.io/aimeded-website/
- Vite + React 18 + TypeScript
- React Router for client-side routing
- Tailwind CSS + shadcn/ui (Radix primitives)
- Bun as the package manager and runtime in CI
Requires Bun (or Node + npm if you prefer — package.json works either way).
bun install
bun run dev # start dev server on http://localhost:8080
bun run build # production build
bun run preview # preview the production build locally
bun test # run the vitest suitepublic/images/ Local team photos served as static assets
src/
pages/ Route-level components (Index, Overview, Learn, GetInvolved)
components/ Page sections and shared UI
components/ui/ shadcn/ui primitives
assets/ Bundled images (hero, logos, etc.)
Pushes to main trigger .github/workflows/deploy.yml, which builds the site with Bun and publishes the dist/ folder to GitHub Pages. The workflow also copies index.html to 404.html so client-side routes resolve on direct navigation.
The site is served from a sub-path (/aimeded-website/), so:
vite.config.tssetsbase: "/aimeded-website/"BrowserRouteris configured with the matchingbasename- References to files in
public/must be prefixed withimport.meta.env.BASE_URL(e.g.`${import.meta.env.BASE_URL}images/foo.jpg`), not a leading/, or they will 404 in production.