# BIO POD — website
A ten-page, static marketing website for **BIO POD**, the biological wastewater treatment brand of
Nuage International Private Limited (Fusion Homes group). The site presents the BIO POD tank, the
MBBR and reed-bed configurations, sector applications, reported project experience, and an
interactive map of the 14 districts of Kerala.
Built with **HTML5, CSS3 and vanilla JavaScript (ES2020+)**. No framework, no build-time CSS
processor and no runtime third-party requests. Leaflet and all fonts are vendored locally.
---
## Quick start
```powershell
# from biopod-website/
node scripts/build.mjs # composes the ten pages, sitemap, robots, manifest
node scripts/serve.mjs # http://127.0.0.1:4173
```
Open . `npm run build`, `npm run serve`, `npm run shots` and `npm run verify`
wrap the same scripts if you prefer npm.
The only prerequisite is Node.js (tested with Node 24). There are no dependencies to install.
**You can also open `index.html` directly from disk.** The district boundaries are embedded as
`assets/js/kerala-geojson.js` and a companion `assets/fonts/fonts-embedded.css` carries the typefaces
as data URIs for the `file://` case, so the map, the fonts and all interactions work when the folder is
double-clicked. Browsers still block the font *files* requested by `fonts.css` over `file://` (a CORS
rule); those failed requests are harmless and are replaced by the embedded stylesheet. Serving the
folder is the recommended way to work.
---
## Project layout
```
biopod-website/
├── index.html … contact.html Generated pages (ten)
├── assets/
│ ├── css/ style.css · components.css · animations.css · responsive.css
│ ├── js/ main.js · navigation.js · animations.js · interactions.js
│ │ district-data.js · kerala-map.js · enquiry-form.js
│ │ kerala-geojson.js (generated, for file://)
│ ├── fonts/ self-hosted WOFF2 + fonts.css (+ generated fonts-embedded.css)
│ ├── icons/ biopod-logo.svg · biopod-logo-white.svg · favicon.svg · apple-touch-icon.png
│ ├── images/ og-image.png
│ └── vendor/leaflet/ leaflet.js, leaflet.css (1.9.4)
├── public/data/kerala-districts.geojson 14 district polygons, local
├── src/
│ ├── pages/ page fragments with JSON front matter (source of truth)
│ ├── partials/ head, header, footer, tank schematic, hero illustration
│ └── site.config.mjs navigation, contact facts, social links
├── scripts/
│ ├── build.mjs page composition + sitemap/robots/manifest + link check
│ ├── perf.mjs local FCP/LCP/CLS measurement
│ ├── serve.mjs static development server
│ ├── build-geojson.mjs rebuild the district dataset from source
│ ├── fetch-assets.mjs re-download fonts and Leaflet
│ ├── shots.mjs screenshots at five widths (visual review)
│ ├── verify.mjs functional, layout and axe verification
│ └── generate-og.mjs regenerates the Open Graph card and touch icon from the logo
├── artifacts/ screenshots and verification output
├── docs/ notes on the map data and the design system
├── README.md
└── LICENSES.md
```
**Edit `src/pages/*.html` and `src/partials/*`, then run the build.** The official BIO POD logo
(`assets/icons/biopod-logo-white.svg`) is used in the header, mobile menu and footer; the dark
`biopod-logo.svg` is kept for light surfaces and print. Do not redraw, recolour or stretch it — see
`docs/design-system.md`.
**Edit `src/pages/*.html` and `src/partials/*`, then run the build.** The HTML files at the project
root are generated output; editing them directly will be overwritten. The generated files are plain
readable HTML — there is no bundler, hashing or runtime framework.
---
## Pages
| Page | File | Purpose |
|---|---|---|
| Home | `index.html` | Product narrative, technology, configurations, sectors, Kerala map preview, clients, enquiry |
| About | `about.html` | Company profile, story, vision, mission, values, manufacturing, quality and IP |
| Technology | `technology.html` | Why BIO POD was built, the mechanism, the design, performance figures, the treatment pathway, combined configuration, reed bed |
| Solutions | `solutions.html` | Three configurations, comparison table, reclaimed STP space, assessment inputs |
| Applications | `applications.html` | Nine sectors, one editorial chapter each |
| Why BIO POD | `why-biopod.html` | Nine advantages, comparison with conventional STP, silence, odour, the conventional STP problem |
| Projects | `projects.html` | Reported reach, client organisations, delivery process |
| Kerala presence | `kerala-presence.html` | Interactive 14-district map with every district labelled, information panel, enquiry routing |
| Resources | `resources.html` | FAQ, documents on request, treated water reuse guidance |
| Contact | `contact.html` | Enquiry form with validation and district prefill, direct contact details |
---
## Design system
Documented in [docs/design-system.md](docs/design-system.md). In short:
- **Palette** — deep canopy green canvas (`#06120d`), forest panels, warm paper (`#f5f2e9`) and cream
(`#e4ddcb`) surfaces, one living leaf accent (`#9bc47a` on dark, `#3e5d31` on paper). Secondary text
colours are chosen to clear WCAG AA on their own surface.
- **Type** — Inter Tight for display (tight tracking, 500 weight), Inter for text, Instrument Serif
italic as the single editorial counterpoint, IBM Plex Mono for evidence labels and technical
captions. All self-hosted, `font-display: swap`.
- **Composition** — editorial asymmetric grids, a sticky treatment-pathway narrative, numbered
chapters instead of card grids, and a product schematic drawn in SVG rather than stock photography.
- **Motion** — CSS transitions and IntersectionObserver reveals; the pathway diagram highlights stages
as they enter view; counters animate once. Everything is complete and readable with
`prefers-reduced-motion: reduce` and with JavaScript disabled.
### Pointer interactions
Movement is reactive but restrained, and only active on fine-pointer devices with motion allowed
(`@media (hover: hover) and (pointer: fine) and (prefers-reduced-motion: no-preference)`).
`assets/js/interactions.js` adds:
- a soft light that follows the pointer across the hero, page heroes, diagrams, CTA panels, documents
and the map information panel;
- a shallow 3D tilt with a glare highlight on the treatment diagrams and CTA panels;
- magnetic primary buttons that lean toward the cursor (max 5 px);
- pointer parallax on the hero vessel, so the tank shifts against its labels.
CSS-driven hover movement covers the rest of the interface: feature and solution rows, sector index
rows (title slides, tag fades, arrow appears), client cells, document cards, FAQ rows, table rows,
statistics, navigation and footer links, and map tools. Everything is transform, opacity or colour —
no layout shift. Touch devices and reduced-motion users get static, fully readable pages; keyboard
users get the existing visible focus states.
### Illustrations
No authentic BIO POD photography is available, so no photographs are used. All visuals are code
native: an SVG treatment-tank schematic, a reed-bed section, stage-allocation bars, a scale rail and
the boundary map. The schematic is explicitly labelled **"simplified schematic — not an engineering
drawing"** in every instance, and internal compartments are not invented.
---
## The Kerala map
- **Data** — `public/data/kerala-districts.geojson`: 14 features, Polygon geometry, `district`, `slug`,
`dt_code`, `st_code`, `source_year` properties. Regenerate with `node scripts/build-geojson.mjs`
(fetches the verified source, validates structure, ring closure and coordinate bounds, rounds to five
decimals). Source, validation results and licence status: [docs/map-data.md](docs/map-data.md).
- **Rendering** — Leaflet 1.9.4, vendored. No tiles, no remote requests: boundaries are drawn from the
local GeoJSON on a dark panel. Attribution and source are printed under the map.
- **Labels** — every one of the 14 districts is named. Labels are placed at their centroid and nudged
against each other by a small collision solver; when a label moves, a leader line joins it to its
district. A label is dropped only if a close-up view leaves literally no room. Labels are
`aria-hidden` decoration — the polygons carry names and interaction.
- **Interaction** — hover highlights a district and shows a tooltip; click (or Enter/Space on a focused
polygon) selects it, updates the information panel and writes `?district=` to the URL. There is
no district list or search: the map is the only picker, as requested. Clear and "View all districts"
reset both map and panel.
- **Routing** — the selected district flows to the enquiry form as `contact.html?district=#enquiry`
and is validated against the accepted 14-district list. Homepage map clicks open the full map page
with that district preselected.
- **Accessibility** — each polygon is a focusable button with `aria-label` and `aria-pressed`, so every
district can be reached and selected by keyboard; selection changes are announced through a polite
live region, and the information panel restates the district in text.
- **Honesty** — the map shows presence, not installation counts. No district-level project numbers,
capacities or outcomes are published because none are verified.
---
## Enquiry form
- Client-side validation with inline, associated error messages (`aria-invalid`, `aria-describedby`),
phone/email/capacity checks, file type and 10 MB size limits.
- The district, preferred solution and document request can be prefilled from the URL.
- **Submission:** this build has **no backend**. Unless the form's `data-endpoint` is set, submitting
prepares a pre-filled email to `biopodprojects@gmail.com`, shows a clearly-worded result panel and lets
the visitor open it in their mail application or copy the details. The site never claims an enquiry
was sent when it was not.
- To connect a real endpoint, set `data-endpoint="https://…"` on the `