Skip to content

compelling_join_homepage_development_plan.md

Latest commit

 

History

History
145 lines (118 loc) · 5.32 KB

compelling_join_homepage_development_plan.md

File metadata and controls

145 lines (118 loc) · 5.32 KB
Raw

Compelling Join Homepage - Development Plan

Current State Analysis

  • Main "/" route: Requires authentication, shows prayer feed
  • Landing pages: /login and /unauthorized handle unauthenticated visitors
  • Current issues: Process-focused rather than value-focused, lacks compelling reasons to join
  • Technical stack: FastAPI, Jinja2 templates, Tailwind CSS, HTMX

Development Stages

Stage 1: Create Welcome Landing Page Template

Duration: 0.5 days
Files: templates/welcome.html

  • Create new welcome template with compelling hero section
  • Include value proposition headlines from strategic plan
  • Add feature highlights with icons and descriptions
  • Implement responsive design with Tailwind CSS
  • Include primary CTA: "Request Your Invitation"
  • Add social proof placeholders for testimonials

Stage 2: Update Routing Logic

Duration: 0.5 days
Files: app_helpers/routes/auth_routes.py, potentially new welcome route

  • Modify unauthenticated user handling to show welcome page instead of login
  • Create dedicated /welcome route for the new landing page
  • Update redirect logic for unauthorized access
  • Preserve existing /login route for direct access
  • Ensure proper navigation between welcome and login pages

Stage 3: Enhanced Value Proposition Content

Duration: 1 day
Files: templates/welcome.html, templates/components/

  • Implement benefit cards with visual elements
  • Add "How it works" section with 3-step process
  • Create feature showcase with platform screenshots/mockups
  • Add security and privacy trust indicators
  • Include community growth metrics (if available)
  • Create reusable components for consistent styling

Stage 4: Social Proof Integration

Duration: 1 day
Files: Database changes, backend routes, templates

  • Design testimonial data structure (simple JSON or database table)
  • Create admin interface for managing testimonials
  • Implement testimonial display rotation
  • Add community stats display (member count, prayers, etc.)
  • Create placeholder content for initial launch

Stage 5: FAQ and Supporting Content

Duration: 0.5 days
Files: templates/faq.html, templates/about.html, route updates

  • Create comprehensive FAQ section addressing join concerns
  • Develop "About" page explaining mission and values
  • Add privacy policy link and security information
  • Ensure mobile-optimized design for all new pages
  • Link these pages from the main welcome page

Stage 6: CTA Optimization and Multiple Entry Points

Duration: 0.5 days
Files: templates/welcome.html, CSS/JS updates

  • Implement multiple CTA buttons throughout the page
  • Add urgency elements (limited access, growing community)
  • Create "Learn More" secondary CTA with expandable content
  • Add smooth scrolling and better UX interactions
  • Implement proper focus states for accessibility

Stage 7: Analytics and Performance Setup

Duration: 0.5 days
Files: Templates, potential new tracking helpers

  • Add conversion tracking for invitation requests
  • Implement time-on-page and engagement metrics
  • Create simple event tracking for CTA clicks
  • Set up bounce rate monitoring
  • Add performance optimization (image lazy loading, etc.)

Stage 8: Mobile Optimization and Polish

Duration: 0.5 days
Files: CSS updates, template refinements

  • Ensure fully responsive design across devices
  • Optimize loading performance for mobile
  • Add touch-friendly interactions
  • Test and refine visual hierarchy
  • Final content and copy editing

Technical Implementation Details

New Routes Required

  • GET /welcome - Main landing page for unauthenticated visitors
  • GET /about - About page with mission/values
  • GET /faq - Frequently asked questions
  • POST /testimonials - Admin route for managing testimonials (Stage 4)

Template Structure

templates/
├── welcome.html          # New main landing page
├── about.html           # Mission and values
├── faq.html             # Frequently asked questions
└── components/
    ├── hero_section.html
    ├── feature_cards.html
    ├── testimonials.html
    └── trust_indicators.html

Database Changes (Stage 4)

  • Optional: Add testimonials table for social proof management
  • Alternative: Use JSON configuration files for easier management

Routing Logic Changes

  1. Unauthenticated access to "/" → redirect to "/welcome"
  2. "/welcome" → New compelling landing page
  3. "/login" → Preserved for direct access
  4. "/unauthorized" → Update to link to "/welcome"

Success Metrics

  • Invitation request conversion rate (target: 15%+ improvement)
  • Time on page for new visitors (target: 2+ minutes)
  • Bounce rate reduction (target: 20% improvement)
  • User progression from welcome → login → invitation request

Content Requirements

  • Compelling headlines and value propositions
  • 3-5 testimonials from beta users
  • Feature screenshots or mockups
  • Community statistics (if available)
  • FAQ content addressing common concerns

Dependencies

  • No new external dependencies required
  • Uses existing FastAPI, Jinja2, Tailwind CSS stack
  • Can be implemented incrementally without breaking existing functionality

Rollback Plan

  • All existing routes remain functional
  • New welcome page can be disabled by reverting routing changes
  • Stages can be implemented and tested independently