metro's-seasonal_web_design

Seasonal Website A website that redesigns itself for the season. Seasonal Website is a proof-of-concept demo showing that a website can be redesigned automatically for each occasion, such as Christmas, Halloween, or Eid, by an AI agent working within firm guardrails. The demo uses a fictional Sample Café with Home, Menu, About, and Contact sections. Choose a season, and the agent restyles the café’s colors, typography, layout, decorations, and copy. Every redesign is checked before it goes live, so the site’s structure and function survive each change. Why it matters Seasonal themes are usually hand-built, one per occasion, and switched by hand. This project explores a different approach: the occasion triggers the redesign, and an agent produces it. The demo proves the full loop, from occasion to validated result, as a stepping stone toward a production system. How it works - Pick an occasion. Choose a preset (Christmas, Halloween, Workers’ Day, Children’s Day, Eid al-Fitr) or type your own, such as “Cherry Blossom Festival.” - The agent redesigns the site. The season and the site’s current HTML, CSS, and JavaScript go to an AI agent, which returns updated files. The agent may only change the three site files. - Every result is validated. The navigation, all four sections, and the contact form must still work, and the code must parse. Invalid output keeps the previous version and shows an error. - Browse and undo. Step back and forward through the last five versions, or reset to the original at any time. - Runs without an API key. A built-in designer covers the demo when no live agent is configured, and a visible notice shows when the fallback is in use. Guardrails - Placeholder-only content: no real addresses, phone numbers, prices, or claims. - WCAG AA text contrast. - Usable on phones. - Writes restricted to the site folder. - Rate limiting and secrets redacted from error messages. - Proof-of-concept limits This is a demo, not a production system. Occasions are triggered by toggles rather than a calendar, which a real system would use instead (for example, switching to a Christmas design automatically on December 1). Version history is kept in memory, so a restart clears it. Without a live agent, the built-in designer reuses one layout with different palettes and decorations rather than a fully free redesign. Getting started Requires Python 3.14. Install dependencies, copy .env.example to .env, and run python run.py, then open http://127.0.0.1:5000. Run the tests with python -m pytest -q. Docker is also supported.