S26 Gallery

Student project gallery for Hawaiʻi School for Girls at La Pietra.

This started as a Google AI Studio export and now runs as a normal Vite project. It is intended to live in its own GitHub repository and deploy to https://lpcode808.github.io/s26-gallery/.

Local Setup

Prerequisite: Node.js 20+.

npm install
npm run dev

Open the local URL printed by Vite (defaults to http://localhost:3000).

Project Shape

• src/ — React app, data, styles.
  • App.tsx — gallery + per-student "legacy" view, filters, project dialog.
  • constants.ts — project records (edit here to add new work).
  • types.ts — Project type and THEME_PROMPTS for assignment context.
• public/images/ — project cover images, served as static assets.
• docs/ADDING_PROJECTS.md — field guide for adding gallery entries.
• reference-screenshots/ — original gallery screenshots, kept for design provenance.
• metadata.json — retained from the AI Studio export.

Adding a Project

Drop the image into public/images/, then add an object to SAMPLE_PROJECTS in src/constants.ts. The asset() helper at the top of that file handles the base path for both dev and GitHub Pages. See docs/ADDING_PROJECTS.md for required fields and conventions.

Scripts

npm run dev      # local dev server
npm run lint     # tsc --noEmit (TypeScript-only check)
npm run build    # production build to dist/
npm run preview  # serve the production build locally

Run npm run lint and npm run build before merging.

Deploy

Pushing to main triggers .github/workflows/deploy.yml, which:

1. Installs deps with npm ci --ignore-scripts.
2. Runs lint + build.
3. Publishes dist/ to GitHub Pages.

GitHub repo settings → Pages → Source must be set to GitHub Actions.

If the repo URL changes, update base in vite.config.ts to match the new subpath (e.g. /new-name/).