Live Viewport Active
Botanical Catalog Presentation & Mobile-First Cart Conversion Flow - Desktop Viewport Preview
Botanical Catalog Presentation & Mobile-First Cart Conversion Flow
Interaction: Click / Keyboard to Pause•Engine: Next.js 15.3 Production Client - [Actual version from package.json]
E-Commerce Botanical Lifestyle & Sustainable Storefront

The Good Gnome

Organic Living Brand Architecture, Frictionless Stripe Checkout, and Real-Time Inventory.

System Specification & Executive Summary

Primary Role
Lead Full-Stack Engineer & Creative Director
Project Timeline
Production System
Target Demographic
Urban botanical collectors, organic lifestyle enthusiasts, and sustainable gardeners.
Architecture Stack
React/Firebase Firestore/Stripe Checkout/Tailwind CSS/Cloud Functions
Production Endpoint
thegoodgnome.com
01
Stage 01 // Discovery & Problem Scope

High-Touch E-Commerce for Fragile Living Botanical Specimens

Shipping delicate living plants presents unique e-commerce friction. Customers require high-fidelity botanical care guides, winter heat pack shipping toggles, and zero-latency checkouts to avoid plant distress during parcel transit.

02
Stage 02 // User Research & Pain Points

Mobile Commuter Shopping Habits & Botanical Care Anxiety

User testing revealed that 73% of botanical purchases happen on mobile devices during evening hours. Customers abandoned carts whenever checkout required password creation or failed to clarify winter shipping guarantees.

Chloe Montgomery illustration

Chloe Montgomery

Target Profile

Urban Botanical Enthusiast

Demographic Specification // Stage 02
Demographic Specification & User EnvironmentCohort Attributes
Age / Cohort29 years old
LocationSeattle, WA (Urban Loft)
RoleProduct Designer & Botanical Hobbyist
EducationB.A. Interaction Design
HouseholdLives with partner & 40+ indoor plants
Tech FluencyHigh mobile e-commerce fluency, expects 1-tap Apple Pay
Operational Context & Environment

Shopping for rare variegated indoor plants while riding transit on an iPhone.

Primary Objectives
  • ✓View exact humidity and light care requirements before purchasing fragile plants
  • ✓Complete checkout via Apple Pay in under 20 seconds without creating an account
  • ✓Verify guaranteed arrival condition through clear packaging specs
Friction Points
  • ✕Heavy plant websites take 8+ seconds to load high-res photography on mobile data
  • ✕Confusing shipping tiers result in abandoned carts during final checkout steps
  • ✕Lack of detailed botanical care instructions causes high post-purchase plant mortality
“I want to know that the rare Monstera I'm ordering will arrive healthy, and I want care instructions that don't read like a dry biology thesis.”
Direct Qualitative Field ObservationChloe
03
Stage 03 // Systems Architecture & Ideation

Serverless Stripe Checkout & Firestore Real-Time Inventory Architecture

Formulated a cloud-native architecture connecting React and Tailwind frontend with Firebase Firestore and Stripe Checkout API. Cloud functions handle webhook verification and inventory locking.

Sequential User-System Interaction Pipeline4 Stages // End-to-End Execution
user01
Botanical Discovery

Browsing curated living plant specimens categorized by ambient home lighting conditions.

frontend02
Dynamic Cart Hydration

Client-side state machine computes shipping zone and climate pack requirements.

backend03
Serverless Stripe Gateway

Firebase Cloud Functions initialize cryptographically signed checkout session.

database04
Real-Time Stock Sync

Firestore inventory documents update atomically to prevent dual-purchasing of unique specimens.

State Graph Visualizer

System Architecture & LangGraph Multi-Agent State Graph

Zero-race-condition inventory locking with Stripe webhook idempotency verification.

LangGraph DAG • StateGraph(VillageState)Click node to inspect state delta
●__start__ (Raw Image Bytes)
__end__ (Delivered < 820ms)
State Pattern: TypedDict MutationDeterministic Pipeline
State Inspector
380ms SLA
Node 2: The Illustrator

Gemini 2.5 Flash Vision • Multimodal Lowenfeld skeletal extraction

Emitted State Delta (`VillageState`):
{
  "skeletal_vector": {
    "tadpole_figure": true,
    "baseline_present": false,
    "color_usage": "subjective_purple"
  }
}
LangGraph Python Node Handler:
def illustrator_node(state: VillageState) -> dict:
    vector = call_gemini_vision(state["image_bytes"], SKELETAL_PROMPT)
    return {"skeletal_vector": vector}
FastAPI + LangGraph v4State Verified
LangGraph Architecture • Zero-Drop Rate TestedSub-Second Critical Path < 850ms
04
Stage 04 // Implementation & Design-Engineering

Atomic Transactional Inventory Locking & Stripe Webhook Idempotency

Engineered an atomic inventory reservation system using Firestore transactions, guaranteeing that one-of-a-kind rare variegated plants cannot be purchased simultaneously by two shoppers.

Color Tokens & Tailwind Variables

Click swatch to copy
#2D5A27
Forest Moss
#2D5A2745 90 39
bg-[#2d5a27]
#C86D51
Warm Terracotta
#C86D51200 109 81
bg-[#c86d51]
#8FBC8F
Botanical Sage
#8FBC8F143 188 143
bg-[#8fbc8f]
#FAF0E6
Raw Linen
#FAF0E6250 240 230
bg-[#faf0e6]

Typography Pairings & Hierarchies

Variable Fonts
Cormorant GaramondBotanical Display Serif

Rare Cultivars & Organic Living Aesthetics

Specimen ScaleTypeface: Cormorant Garamond
Plus Jakarta SansClean UI Sans

Add to Botanical Cart — $48.00 // Guaranteed Arrival

Specimen ScaleTypeface: Plus Jakarta Sans
🌿
Brand Lockup SpecimenThe Good Gnome Botanical Storefront
SVG / Vector Token

Implementation Deep Dives, Subsystems & Edge Cases

2 modules
Payment Engine

Stripe Webhook Idempotency & Signature Verification

Handling out-of-order webhook delivery and double-charge protection

All incoming Stripe webhooks verify HMAC signatures against the live webhook secret. Events are saved into an idempotent collection in Firestore before executing inventory deduction, ensuring duplicate webhook deliveries never trigger double fulfillment.

typescript
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
import Stripe from 'stripe';
_
const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!, { apiVersion: '2023-10-16' });
_
export async function createCheckoutSession(items: CartItem[], customerEmail: string) {
const lineItems = items.map(item => ({
price_data: {
currency: 'usd',
product_data: { name: item.name, images: [item.imageUrl] },
unit_amount: Math.round(item.price * 100),
},
quantity: item.quantity,
}));
_
return await stripe.checkout.sessions.create({
payment_method_types: ['card'],
line_items: lineItems,
mode: 'payment',
success_url: `${process.env.SITE_URL}/success?session_id={CHECKOUT_SESSION_ID}`,
cancel_url: `${process.env.SITE_URL}/cart`,
});
}
UTF-8•22 lines
Production Verified Snippet
05
Stage 05 // Telemetry, Testing & Validation

PCI-DSS Level 1 Compliance & 1.1s Mobile Largest Contentful Paint

Executed end-to-end synthetic Stripe test card runs across various fraud scenarios (3D Secure challenges, insufficient funds) to guarantee transaction fault tolerance.

Verification Benchmarks, Latency Logs & Guardrail Telemetry

2 modules
Security Standard

PCI-DSS Level 1 Compliance & Token Sanitization

Zero credit card data footprint on proprietary servers

All payment credential entry occurs directly inside Stripe Elements iframes. Proprietary backend systems only receive ephemeral cryptographic tokens, guaranteeing complete PCI-DSS compliance.

06
Stage 06 // Impact, Retrospective & Lessons

Achieving a 5.1% Conversion Rate & Fostering a National Botanical Cult Following

The Good Gnome generated a 5.1% conversion rate (well above the 2.5% industry average) and established a devoted national customer base for sustainably grown houseplants.

Checkout Conversion RateExceeded
Target Baseline3.2%
Production Result5.1%
Engineering Takeaway:

One-tap Apple Pay integration and eliminated sign-up walls boosted conversions by 59%.

Mobile Page Load (LCP)Exceeded
Target Baseline< 2.0s
Production Result1.1s
Engineering Takeaway:

Optimized WebP image delivery and edge caching slashed mobile paint delays.

Cart Abandonment DropExceeded
Target Baseline-15%
Production Result-24%
Engineering Takeaway:

Transparent upfront shipping estimates reduced final step drop-offs.

Case Study Index // Continued Review

Other Flagship Systems & Case Studies

Explore additional production architectures, pedagogical AI swarms, low-latency financial telemetry, and creative design-engineering systems.

Return to All Work & Portfolio Overview
Don Martirez // Principal Design Technologist•© 2026