fiery-sophie

bySeth

Sophie rain

LandingLoginDashboardScenesSceneMood SelectorMoodsSignupProfile
Landing

Comments (0)

No comments yet. Be the first!

System Requirements

System Requirement Document
Page 1 of 7

System Requirements Document (SRD)

Project: fiery-sophie Prepared for: Seth Date: 2026-03-01 Version: 1.0.0 Locale: Australia (AU) β€” Timezone: AEST/AEDT, Currency: AUD

1. Introduction

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.

2. System Overview

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.

Page 2 of 7

3. Functional Requirements

Requirements are expressed as user story points based on the gathered context.

  • As a User, I should be able to visit the platform and immediately be immersed in a visually stunning weather-inspired landing experience.
  • As a User, I should be able to browse and select different ambient weather scenes or moods (e.g. rain, storm, golden hour, mist).
  • As a User, I should be able to interact with the visual environment (e.g. click, hover, scroll to trigger atmospheric effects).
  • As a User, I should be able to toggle ambient background sounds on or off to accompany the visual experience.
  • As a User, I should be able to customise the intensity or mood of the current scene (e.g. light rain vs heavy storm).
  • As a User, I should be able to share a specific scene or mood with others via a link.
  • As a Guest, I should be able to access the full ambient experience without needing to create an account.
  • As a Registered User, I should be able to create an account and save my favourite scenes or moods.
  • As a Registered User, I should be able to set a default scene that loads when I return to the platform.
  • As an Admin, I should be able to manage available scenes, moods, and content from an admin dashboard.
  • As an Admin, I should be able to view platform usage analytics (active users, popular scenes, session durations).

4. User Personas

PersonaDescriptionGoals
GuestAn unauthenticated visitor who stumbles upon the platform.Explore and enjoy the ambient experience without friction or sign-up barriers.
Registered UserA returning user who values personalisation and continuity.Save favourite scenes, set preferences, and build a personalised ambient retreat.
AdminThe platform owner/operator (likely Seth or a trusted operator).Manage content, monitor usage, and maintain platform health.

5. Visuals, Colors and Theme

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.

Page 3 of 7

Colour Palette

RoleColour NameHex
PrimaryEmber Gold#F4A022
SecondaryDeep Rain Slate#2E4057
AccentSoft 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 / CalmRainfall Green#4CAF8E

Typography

  • Display / Headings: Playfair Display β€” elegant, slightly dramatic, evokes the poetic "Sophie Rain" identity.
  • Body: Inter β€” clean, modern, highly readable on all screen sizes.
  • Accent / Labels: DM Mono β€” subtle techy/atmospheric feel for labels and data overlays.

Theme Modes

  • Dark Mode (default): Deep stormy backgrounds with glowing ember and flame accents β€” immersive and cinematic.
  • Light Mode: Soft frosted sky tones for daytime/casual browsing.

6. Signature Design Concept

Page 4 of 7

πŸ”₯🌧️ "The Storm Between" β€” A Living, Breathing Dual-Force Homepage

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:

  • Left side: A deep, smouldering ember landscape β€” slow-moving particles of ash and light drift upward like embers from a dying fire. The background pulses with deep amber and burnt orange. Warm light bleeds from below the fold. The text here glows softly: "Feel the warmth."
  • Right side: A dark, rainy stormscape β€” animated rain streaks fall diagonally across the screen, subtle lightning flickers in the distance every 8–12 seconds. The air feels cool and heavy. The text reads: "Find the calm."

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:

  • Hovering over the ember side causes nearby particles to float toward the cursor.
  • Hovering over the rain side causes tiny ripple rings to emanate from the cursor position (as if touching a water surface).
  • Clicking anywhere triggers a brief burst of either embers or rain droplets depending on which side is clicked.
  • The site title "fiery-sophie" is rendered in a live flame-text shader on the left, and a rain-distortion text effect on the right β€” the two versions of the logo existing simultaneously.

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.

Page 5 of 7

7. Non-Functional Requirements

CategoryRequirement
PerformanceInitial page load under 3 seconds on standard Australian NBN connections (25 Mbps).
PerformanceSmooth WebGL/Canvas animations at 60fps on modern desktop browsers; graceful degradation on mobile.
ScalabilitySystem should support up to 10,000 concurrent users without degradation.
Availability99.9% uptime SLA for production environment.
ResponsivenessFully responsive across desktop, tablet, and mobile (iOS Safari and Android Chrome prioritised).
AccessibilityWCAG 2.1 AA compliance; all interactive elements keyboard-navigable; animations respect prefers-reduced-motion.
SecurityHTTPS enforced across all endpoints. User passwords hashed with bcrypt. JWT-based auth with refresh tokens.
PrivacyCompliant with Australian Privacy Act 1988. No third-party data sold. Clear privacy policy displayed.
Browser SupportLatest 2 versions of Chrome, Firefox, Safari, Edge.
InternationalisationDefault locale: en-AU. Date formats: DD/MM/YYYY. Time: AEST/AEDT.

8. Tech Stack

Frontend

LayerTechnologyReason
Web UIReactComponent-based UI, rich ecosystem for animations and WebGL integration.
Animations / Visual FXThree.js / React Three FiberWebGL-powered particle systems, fluid simulations, and shader effects.
StylingTailwind CSSUtility-first, fast theming, dark/light mode support.

Backend

LayerTechnologyReason
API ServerFastAPI (Python)High-performance async API, ideal for real-time and media-serving endpoints.

Database

LayerTechnologyReason
Relational (primary)MySQL / MariaDBUser accounts, saved scenes, preferences, admin data.
MigrationsAlembicSchema version control for MySQL/MariaDB.
Page 6 of 7

Infrastructure & Orchestration

LayerTechnologyReason
Local DevDocker + Docker ComposeConsistent local environment across all services.
ProductionKubernetesScalable 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.

9. Assumptions and Constraints

Assumptions

  • The primary target audience is English-speaking users based in Australia, though the platform is globally accessible.
  • Seth will act as the primary Admin for the initial launch.
  • The platform will launch as a web-only experience (v1.0); mobile app (React Native) may be considered for a future release.
  • Users are expected to be on modern browsers with WebGL support; a static fallback will be provided for unsupported browsers.
  • Ambient sound assets will be licensed or royalty-free (e.g. sourced from Freesound.org or a paid library).
  • AEST (UTC+10) / AEDT (UTC+11) will be used as the default server and display timezone.

Constraints

  • Budget and timeline for v1.0 are not yet defined; the SRD will be scoped conservatively.
  • WebGL-intensive animations may not perform well on low-end mobile devices; graceful degradation is required.
  • All media assets (sounds, textures, shaders) must be either custom-built or appropriately licensed.
  • Australian Privacy Act 1988 compliance is mandatory from day one.
Page 7 of 7

10. Glossary

TermDefinition
SRDSystem Requirements Document β€” the master reference for project requirements.
Ambient SceneA full-screen, animated visual environment (e.g. rain, fire, mist) that immerses the user.
MoodA named atmospheric preset combining visual, colour, and sound settings (e.g. Ember Glow, Thunderstorm).
Mood SelectorThe radial UI control allowing users to dial in their desired atmospheric mood.
WebGLWeb Graphics Library β€” a JavaScript API for rendering 2D and 3D graphics in the browser using the GPU.
ShaderA small GPU program used to produce visual effects such as the flame-text or rain-distortion effects.
Particle SystemA rendering technique used to simulate phenomena like rain, embers, mist, and smoke.
JWTJSON Web Token β€” a compact, URL-safe token used for user authentication and session management.
AlembicA lightweight database migration tool for SQLAlchemy/Python, used here with MySQL/MariaDB.
AEST/AEDTAustralian Eastern Standard Time (UTC+10) / Australian Eastern Daylight Time (UTC+11).
WCAG 2.1 AAWeb Content Accessibility Guidelines v2.1, Level AA β€” the accessibility standard targeted by this project.
FastAPIA modern, high-performance Python web framework for building APIs.
Docker ComposeA tool for defining and running multi-container Docker applications locally.
KubernetesAn 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

Landing design preview
Login: Sign In
Dashboard: View Analytics
Dashboard: Monitor Sessions
Scenes: Manage Scenes
Scenes: Add or Edit Scene
Moods: Manage Moods