Project: fiery-sophie Prepared for: Seth Date: 2026-03-01 Version: 1.0.0 Locale: Australia (AU) β Timezone: AEST/AEDT, Currency: AUD
This document outlines the System Requirements for fiery-sophie, a project inspired by the poetic and evocative identity of "Sophie Rain." Based on the initial conversation context, fiery-sophie is envisioned as an immersive, visually-driven relaxation and ambient experience platform β blending weather-inspired aesthetics with calming, interactive visual and/or audio elements.
This SRD serves as the foundational reference for all design, development, and delivery decisions for the fiery-sophie project. It will evolve as requirements are refined with Seth.
β οΈ Note to Seth: The initial context provided was minimal. This SRD has been bootstrapped based on reasonable interpretation of the conversational hints (weather, calming, relaxation, visual/interactive experience). Please review and flag any sections that need correction or expansion.
fiery-sophie is a web-based ambient experience platform that immerses users in weather-inspired, visually rich environments. The platform provides a serene, aesthetic escape β combining atmospheric visuals, optional ambient soundscapes, and interactive elements to create a unique digital relaxation space.
The system will be accessible via a web browser (desktop and mobile-responsive), with a focus on visual beauty, smooth animations, and effortless user interaction. The platform is designed for a broad consumer audience seeking calm, beauty, and sensory immersion online.
Requirements are expressed as user story points based on the gathered context.
| Persona | Description | Goals |
|---|---|---|
| Guest | An unauthenticated visitor who stumbles upon the platform. | Explore and enjoy the ambient experience without friction or sign-up barriers. |
| Registered User | A returning user who values personalisation and continuity. | Save favourite scenes, set preferences, and build a personalised ambient retreat. |
| Admin | The platform owner/operator (likely Seth or a trusted operator). | Manage content, monitor usage, and maintain platform health. |
The visual identity of fiery-sophie draws from the duality in its name β "fiery" (warmth, energy, passion, golden light) and "Sophie Rain" (softness, coolness, calm, flowing water). The theme lives in the tension and harmony between these two forces.
| Role | Colour Name | Hex |
|---|---|---|
| Primary | Ember Gold | #F4A022 |
| Secondary | Deep Rain Slate | #2E4057 |
| Accent | Soft Coral Flame | #E8634A |
| Background (dark) | Midnight Storm | #0D1B2A |
| Background (light) | Frosted Sky | #EFF4F9 |
| Text (primary) | Warm Ivory | #F5EFE6 |
| Text (secondary) | Cool Mist Grey | #A9B8C3 |
| Success / Calm | Rainfall Green | #4CAF8E |
Playfair Display β elegant, slightly dramatic, evokes the poetic "Sophie Rain" identity.Inter β clean, modern, highly readable on all screen sizes.DM Mono β subtle techy/atmospheric feel for labels and data overlays.When a user first lands on fiery-sophie, they don't see a typical webpage β they step into a scene.
The Landing Experience:
The homepage is split by a living vertical divide β a shimmering, slowly drifting boundary that separates two worlds:
The Divide: The boundary between the two worlds is not a hard line β it's a living fluid simulation, rendered in WebGL/Canvas, where fire and rain particles collide and dissolve into each other in real-time. The divide breathes, sways, and shifts as the user moves their cursor toward it. Hovering over the divide triggers a micro-explosion of steam particles β fire meeting rain β before settling back.
Scroll Interaction: As the user scrolls down, the divide slowly dissolves and the two worlds merge into a single unified twilight scene β a rain-soaked landscape lit by embers from afar. This merged state introduces the platform's core mood selector.
Mood Selector: Presented as a radial dial β a beautiful circular interface element styled like a compass or an antique barometer β users spin it to select their desired mood (e.g. Gentle Rain, Thunderstorm, Golden Hour, Misty Dawn, Ember Glow). As they rotate the dial, the entire background scene morphs and transitions live β no page reload, no button press. Pure, reactive atmosphere.
Micro-Interactions:
Sound Design (optional toggle): On first load, a subtle prompt floats up from the bottom: "Enable atmosphere?" β a single soft button. If accepted, the ambient sounds layer in gradually (crackling embers left, rain pattering right), mixed in stereo to match the spatial split of the visuals.
This is not a website. This is a portal.
| Category | Requirement |
|---|---|
| Performance | Initial page load under 3 seconds on standard Australian NBN connections (25 Mbps). |
| Performance | Smooth WebGL/Canvas animations at 60fps on modern desktop browsers; graceful degradation on mobile. |
| Scalability | System should support up to 10,000 concurrent users without degradation. |
| Availability | 99.9% uptime SLA for production environment. |
| Responsiveness | Fully responsive across desktop, tablet, and mobile (iOS Safari and Android Chrome prioritised). |
| Accessibility | WCAG 2.1 AA compliance; all interactive elements keyboard-navigable; animations respect prefers-reduced-motion. |
| Security | HTTPS enforced across all endpoints. User passwords hashed with bcrypt. JWT-based auth with refresh tokens. |
| Privacy | Compliant with Australian Privacy Act 1988. No third-party data sold. Clear privacy policy displayed. |
| Browser Support | Latest 2 versions of Chrome, Firefox, Safari, Edge. |
| Internationalisation | Default locale: en-AU. Date formats: DD/MM/YYYY. Time: AEST/AEDT. |
| Layer | Technology | Reason |
|---|---|---|
| Web UI | React | Component-based UI, rich ecosystem for animations and WebGL integration. |
| Animations / Visual FX | Three.js / React Three Fiber | WebGL-powered particle systems, fluid simulations, and shader effects. |
| Styling | Tailwind CSS | Utility-first, fast theming, dark/light mode support. |
| Layer | Technology | Reason |
|---|---|---|
| API Server | FastAPI (Python) | High-performance async API, ideal for real-time and media-serving endpoints. |
| Layer | Technology | Reason |
|---|---|---|
| Relational (primary) | MySQL / MariaDB | User accounts, saved scenes, preferences, admin data. |
| Migrations | Alembic | Schema version control for MySQL/MariaDB. |
| Layer | Technology | Reason |
|---|---|---|
| Local Dev | Docker + Docker Compose | Consistent local environment across all services. |
| Production | Kubernetes | Scalable container orchestration for production deployment. |
Note: NoSQL (MongoDB), VectorDB (WeaviateDB), and AI model integrations (LLM routing via LiteLLM, Langchain) are not included in v1.0 of this project based on current requirements. These can be introduced in future iterations if features such as AI-driven mood recommendations or semantic search are desired.
| Term | Definition |
|---|---|
| SRD | System Requirements Document β the master reference for project requirements. |
| Ambient Scene | A full-screen, animated visual environment (e.g. rain, fire, mist) that immerses the user. |
| Mood | A named atmospheric preset combining visual, colour, and sound settings (e.g. Ember Glow, Thunderstorm). |
| Mood Selector | The radial UI control allowing users to dial in their desired atmospheric mood. |
| WebGL | Web Graphics Library β a JavaScript API for rendering 2D and 3D graphics in the browser using the GPU. |
| Shader | A small GPU program used to produce visual effects such as the flame-text or rain-distortion effects. |
| Particle System | A rendering technique used to simulate phenomena like rain, embers, mist, and smoke. |
| JWT | JSON Web Token β a compact, URL-safe token used for user authentication and session management. |
| Alembic | A lightweight database migration tool for SQLAlchemy/Python, used here with MySQL/MariaDB. |
| AEST/AEDT | Australian Eastern Standard Time (UTC+10) / Australian Eastern Daylight Time (UTC+11). |
| WCAG 2.1 AA | Web Content Accessibility Guidelines v2.1, Level AA β the accessibility standard targeted by this project. |
| FastAPI | A modern, high-performance Python web framework for building APIs. |
| Docker Compose | A tool for defining and running multi-container Docker applications locally. |
| Kubernetes | An open-source container orchestration platform used for production deployment and scaling. |
Document prepared by Claude β AI Assistant | fiery-sophie SRD v1.0 | 2026-03-01 Prepared for Seth | Project: fiery-sophie | Locale: AU

No comments yet. Be the first!