10 to Win Design Guidelines

1. Executive Overview 2. System Architecture 3. Design System 4. Task Prioritization 5. Habits Module (10 for Life) 6. Integrations 7. Security & RBAC 8. Session Management 9. Data Encryption 10. Database Schema 11. API Reference 12. User Dashboard 13. Future Upgrades 14. Documentation & Resources + App Completeness Checklist

1. Executive Overview

10 to Win is a comprehensive productivity ecosystem built with React Native and Expo, designed to help users manage their time through prioritized 10-minute task lists and habit tracking.

Core Philosophy

The app operates on the principle that breaking work into focused 10-minute blocks maximizes productivity while minimizing overwhelm. Users focus on their "next 10 minutes" rather than an endless task list.

Key Modules

10 to Win (Tasks)

Intelligent task prioritization with 10+ task modes, swipe gestures, deadline tracking, and long-term project support.

10 for Life (Habits)

Track up to 10 daily habits with Yes/No, Quantity, and Timed types. Features 10-day streak milestones and Perfect 10 celebrations.

Subscription Tiers

Freemium model with Free, Basic ($4.99/mo), Pro ($9.99/mo), and Lifetime ($149) tiers across Stripe, App Store, and Play Store.

Admin Dashboard

Complete CRUD operations for users, feedback, payments, subscriptions, referrals, analytics, and more.

User Dashboard

Self-service web portal for account management, payment history, referrals, session control, and progress tracking.

Subscription Tiers

Free

3 task modes, basic features

Basic

$4.99/month

5 task modes, integrations

Pro

$9.99/month

10 modes, advanced factors

Lifetime

$149 one-time

All features forever

2. System Architecture

Technology Stack

Layer	Technology	Purpose
Frontend	React Native + Expo SDK	Cross-platform mobile app
Navigation	React Navigation 7+	Tab and stack navigation
State	React Context API	TasksContext, HabitsContext
Animations	Reanimated + Gesture Handler	Smooth UI interactions
Backend	Express.js + TypeScript	API server on port 3001
Database	PostgreSQL + Drizzle ORM	Persistent data storage
Payments	Stripe + IAP	Web and mobile payments

Navigation Structure

MainTabNavigator (Root)

HomeTab

HomeScreen (10-minute task list)

Top10Tab

Top10Screen (highest priority tasks)

TasksTab

TasksScreen (full task list)

TaskDetailScreen

HabitsTab

HabitsScreen (habit overview)

HabitDetailScreen

ModesTab

ModesScreen (task mode selection)

SettingsTab

SettingsScreen

NotificationsScreen

IntegrationsScreen

File Structure

/src

📁 /components Reusable UI components

📁 /contexts TasksContext, HabitsContext

📁 /screens Screen components

📁 /navigation Navigation setup

📁 /types TypeScript interfaces

📁 /utils Utility functions

📁 /constants Theme, colors, spacing

/server

📄 index.ts Express server entry

📄 routes.ts API endpoints

📄 storage.ts Database operations

📄 stripeClient.ts Stripe integration

📄 resendClient.ts Email integration

📄 webhookHandlers.ts Webhook processing

/shared

📄 schema.ts Drizzle schema definitions

/public

📁 /admin Admin dashboard

📁 /dashboard User dashboard

📁 /static Marketing website

3. Design System

iOS 26 Liquid Glass Design

The app follows Apple's iOS 26 Liquid Glass design language - a modernized frosted glass aesthetic with subtle blur, tinting, and organic spring animations.

Color Palette

Primary Colors

Primary
#2563EB

Success
#10B981

Warning
#F59E0B

Danger
#EF4444

Light Mode

Background Root
#FFFFFF

Background Default
#F9FAFB

Text Primary
#111827

Text Secondary
#6B7280

Dark Mode

Background Root
#1F2937

Background Default
#111827

Text Primary
#F9FAFB

Text Secondary
#9CA3AF

Typography Scale

Style	Size	Weight	Usage
Large Title	34pt	Bold (700)	Screen headers, countdown timer
Title 1	28pt	Semibold (600)	Task names on Home
Title 2	22pt	Semibold (600)	Section headers
Headline	17pt	Semibold (600)	List item titles
Body	17pt	Regular (400)	Task descriptions
Callout	16pt	Regular (400)	Metadata
Caption	12pt	Regular (400)	Timestamps, helper text

Spacing System

Token	Value	Usage
`Spacing.xs`	4px	Tight gaps
`Spacing.sm`	8px	Small margins
`Spacing.md`	12px	Medium spacing
`Spacing.lg`	16px	Standard padding
`Spacing.xl`	20px	Section gaps
`Spacing.2xl`	24px	Large sections
`Spacing.3xl`	32px	Major sections

Border Radius

Token	Value	Usage
`BorderRadius.xs`	8px	Small cards, badges
`BorderRadius.sm`	12px	Cards, buttons
`BorderRadius.md`	18px	Modals
`BorderRadius.lg`	24px	Floating elements
`BorderRadius.full`	9999px	Circular elements

Component Specifications

Task Card

Background: White (light) / Dark gray (dark mode)
Corner radius: 12px
Border: 1px solid neutral-200
Padding: Spacing.lg (16px)
Priority indicator: 4px vertical bar on left edge
Active state: Scale 0.98, opacity 0.9

Floating Action Button

Size: 56x56px
Position: Bottom-center, above tab bar
Background: Brand Primary (#2563EB)
Shadow: offset {0, 2}, opacity 0.10, radius 2
Press feedback: Scale 0.95

Category Badge

Shape: Pill (16px corner radius)
Background: Category color at 20% opacity
Text: Category color, Callout Semibold
Padding: 4px vertical, 8px horizontal

4. Task Prioritization System

Priority Score Algorithm

Every task receives a numeric priority score calculated from multiple factors:

function calculatePriority(task: Task): number {
  let score = 0;

  // Urgency Type (base points)
  if (task.urgencyType === "emergency") score += 1000;
  else if (task.urgencyType === "urgent") score += 700;
  else if (task.urgencyType === "moderate") score += 400;
  else if (task.urgencyType === "low") score += 100;

  // Deadline Proximity
  if (task.dueDate) {
    const hoursUntilDue = (dueDate - now) / (1000 * 60 * 60);
    if (hoursUntilDue < 0) score += 1200;      // Overdue
    else if (hoursUntilDue < 2) score += 900;   // Due in 2 hours
    else if (hoursUntilDue < 6) score += 600;   // Due in 6 hours
    else if (hoursUntilDue < 24) score += 400;  // Due today
    else if (hoursUntilDue < 72) score += 200;  // Due in 3 days
  }

  // Importance (1-10 scale, +50 each)
  score += task.importance * 50;  // +50 to +500

  // Divest-Invest Factor (-10 to +10, +30 each)
  score += task.divestInvest * 30;  // -300 to +300

  // Snooze Penalty (-50 per snooze)
  score -= task.snoozeCount * 50;

  return score;
}

Task Modes

Mode	Tier	Description
10-Min Fit	Free	Default mode. Selects highest-priority tasks that fit within 10 minutes total.
Critical First	Free	Shows tasks sorted purely by urgency level (Emergency > Urgent > Moderate > Low).
Quick Wins	Free	Shortest tasks first for momentum building. Shows tasks under 15 minutes.
Deadline Crunch	Basic	Tasks with soonest due dates. Overdue first, then today, this week.
Balance	Basic	Rotates through all categories for work-life balance (1-2 per category).
Chunked	Pro	Breaks large tasks into 10-minute chunks for incremental progress.
Flow Sync	Pro	Matches tasks to current energy and cognitive capacity using Advanced Factors.
Team Unblocker	Pro	Prioritizes tasks where others are waiting on you (blocksOthers, stakeholderWaiting).
Relationship Guard	Pro	Surfaces high-stakes items to protect reputation (delayConsequence, stakeholderWaiting).
Momentum Finish	Pro	Shows nearly-complete tasks for quick wins (progressPercent weighting).

Advanced Factors (Pro-Only)

Pro users can enable 9 additional prioritization factors:

Factor	Values	Score Impact
Energy Level	Low, Medium, High	+20, +40, +60
Cognitive Complexity	Simple, Moderate, Complex	0, -30, -60
Blocks Others	Yes/No + Count	+300 base, +50 per person
Waiting On	None, Internal, External	0, -100, -200
Stakeholder Waiting	None, Colleague, Manager, Client	0, +100, +200, +300
Delay Consequence	None, Inconvenience, Financial, Relationship, Career	0, +50, +150, +200, +300
Progress Percent	0-100%	+3 per percent
Task Age	Days since creation	+30 (1-3d), +75 (3-7d), +150 (7+d)
Skip/View Count	Auto-tracked	-25 per skip/view

5. Habits Module (10 for Life)

Core Concept

The habits module allows users to track up to 10 daily habits, organized into Morning, Anytime, and Evening sections.

Habit Types

Yes/No

Simple binary completion. Did you do it or not?

Example: "Did I exercise today?"

Quantity

Track a target number with progress.

Example: "Drink 8 glasses of water"

Timed

Default 10-minute timer for focused activities.

Example: "Meditate for 10 minutes"

Streak Milestones

The 10-day streak milestone system celebrates consistency:

Starting (0 days)

Bronze Flame (10 days)

Silver Flame (30 days)

Gold Flame (60 days)

Diamond Flame (100 days)

Legendary (365 days)

Daily Score & Perfect 10

Each day, users receive a score based on completed habits. Completing all habits earns a "Perfect 10" celebration with confetti animation.

Streak Protection

Users can skip a habit using "Streak Protection" which preserves their streak. Limited to a configurable window (default: 10 days).

Habit Settings

Setting	Default	Description
Morning Check-In	Off	Notification reminder in the morning
Morning Time	10:00 AM	Time for morning notification
Evening Check-In	Off	Notification reminder in the evening
Evening Time	10:00 PM	Time for evening notification
Streak Protection	On	Allow protected skips
Week Starts On	Sunday (0)	First day of week
10 to Win Sync	Off	Sync habits with task module

Constants

MAX_HABITS = 10 - Maximum habits allowed
DEFAULT_TIMER_MINUTES = 10 - Default timer for Timed habits
PROTECTED_SKIP_WINDOW_DAYS = 10 - Days for streak protection reset

6. Integrations

Stripe Integration

Configured via VS-REP Connector

Stripe handles all web-based payment processing for subscriptions and one-time purchases.

Configuration

// server/stripeClient.ts
import Stripe from 'stripe';

// Credentials retrieved via VS-REP Connector
const credentials = await getCredentials();
const stripe = new Stripe(credentials.secretKey, {
  apiVersion: '2025-08-27.basil'
});

// Exported functions:
- getUncachableStripeClient()  // Get Stripe instance
- getStripePublishableKey()    // For frontend
- getStripeSecretKey()         // For backend
- getStripeWebhookSecret()     // For webhook verification

Stripe Service Methods

Method	Description
`createCustomer(userId)`	Create Stripe customer for user
`createCheckoutSession(...)`	Create checkout session for subscription/payment
`createCustomerPortalSession(...)`	Create billing portal session

Webhook Events Handled

checkout.session.completed - Process successful checkout
customer.subscription.created - New subscription
customer.subscription.updated - Subscription changed
customer.subscription.deleted - Subscription cancelled
invoice.paid - Invoice payment successful

Products & Prices

// Seeded via seed-products.ts
Products:
- 10 to Win Basic: $4.99/mo or $49/yr
- 10 to Win Pro: $9.99/mo or $89/yr
- 10 to Win Lifetime: $149 one-time

Resend Integration

Configured via VS-REP Connector

Resend handles transactional email delivery for feedback notifications and system alerts.

// server/resendClient.ts
import { Resend } from 'resend';

// Credentials retrieved via VS-REP Connector
const { apiKey, fromEmail } = await getCredentials();
const client = new Resend(apiKey);

// Primary function:
await sendFeedbackNotification(type, name, email, message, adminEmails);

Email Templates

Feedback Notification - Sends user feedback to admin emails
Feature Suggestion - Sends feature suggestions to admin emails

Zapier Integration

Power Boost ($10)

Zapier integration allows users to export tasks to external services via webhooks.

How It Works

User configures a Zapier webhook URL in settings
When a task is created/completed, it can be sent to Zapier
Zapier triggers connected workflows (Google Sheets, Slack, etc.)

API Endpoint

POST /api/zapier/export
{
  "deviceId": "user-123",
  "taskId": "task-456",
  "taskTitle": "Complete project proposal",
  "webhookUrl": "https://hooks.zapier.com/...",
  "payload": { /* custom data */ }
}

Response:
{
  "success": true,
  "event": { /* logged event */ },
  "responseCode": 200
}

Todoist Integration

Needs Setup

Todoist integration allows syncing tasks from Todoist into 10 to Win.

        Setup Required: The Todoist integration is installed but needs configuration. Users must connect their Todoist account via OAuth to enable task sync.
      

Planned Features

Import tasks from Todoist projects
Two-way sync for task completion
Map Todoist priorities to 10 to Win urgency levels
Sync due dates and labels

Twilio Integration

Configured

Twilio enables SMS and voice call notifications for urgent tasks.

Capabilities

SMS Notifications - Send text message reminders
Voice Calls - Automated voice call for emergency tasks
Launch Actions - Quick call/text from task details

Integration Architecture

Mobile App

Expo / React Native

Express Server

Port 3001

Stripe

Payments

Resend

Emails

Twilio

SMS / Voice

Zapier

Webhooks

Todoist

Task Import

7. Security & Role-Based Access Control

Role Hierarchy

Master
Level 4

Admin
Level 3

User
Level 2

Viewer
Level 1

Permission Matrix

Permission	Viewer	User	Admin	Master
user.profile.read	Yes	Yes	Yes	Yes
user.profile.write	-	Yes	Yes	Yes
user.tasks.read	Yes	Yes	Yes	Yes
user.tasks.write	-	Yes	Yes	Yes
admin.dashboard	-	-	Yes	Yes
admin.users.read	-	-	Yes	Yes
admin.users.write	-	-	Yes	Yes
admin.users.delete	-	-	Yes	Yes
Manage other admins	-	-	-	Yes
Database operations	-	-	-	Yes

Authentication Flow

User submits credentials (email + password)

Server validates against password_hash (PBKDF2)

Generate session token (256-bit random)

Store session in user_sessions table

Return token to client

Client includes token in Authorization header

Authorization: Bearer <session_token>

Password Security

Algorithm: PBKDF2 with SHA-256
Iterations: 10,000
Salt: 128-bit random per password
Key Size: 256 bits
Storage Format: salt:hash

Middleware Functions

Middleware	Purpose
`sessionAuth`	Validates session token, attaches user to request
`requireRole(role)`	Requires user to have at least specified role level
`requirePermission(perm)`	Requires user to have specific permission
`adminAuth`	Legacy middleware for admin dashboard (supports master password)

Test Users

Development Only: These test users are for development and testing purposes.

Email	Role	Password
testadmin@10towin.co	Admin	admin123
testuser@10towin.co	User	admin123
testviewer@10towin.co	Viewer	admin123

8. Session Management

Session Properties

Property	Type	Description
id	Serial	Auto-increment primary key
userId	Text	Reference to user
sessionToken	Text (unique)	256-bit random token
expiresAt	Timestamp	Session expiration time
ipAddress	Text	Client IP address
userAgent	Text	Browser/device info
createdAt	Timestamp	Session creation time
lastActiveAt	Timestamp	Last activity time

Session Lifecycle

User Sessions

Expire after 30 days
Updated on each request
Multiple sessions per user allowed

Admin Sessions

Expire after 24 hours
Stricter security requirements
IP and user agent tracked

Admin Session Controls

The admin dashboard provides comprehensive session management:

My Sessions

View all active sessions for current admin
See IP address, user agent, and last active time
Revoke individual sessions

All Sessions (Master Only)

View all active sessions across all users
Filter by user, role, or status
Revoke any session
Cleanup expired sessions

Session API Endpoints

Endpoint	Method	Description
/api/admin/my-sessions	GET	Get current admin's sessions
/api/admin/sessions	GET	Get all sessions (Master only)
/api/admin/sessions/:id	DELETE	Revoke a specific session
/api/admin/sessions/cleanup	POST	Remove expired sessions
/api/user/sessions	GET	Get user's active sessions
/api/user/sessions/:id	DELETE	Revoke user's own session

Security Best Practices

Sessions are invalidated on password change
Suspicious activity triggers automatic session revocation
IP address changes logged for audit trail
Session tokens are never logged or exposed

9. Data Encryption (AES-256)

Overview

The app offers optional AES-256 encryption for all locally stored data, providing an additional layer of security for sensitive task and habit information.

Encrypted Data Types

Tasks and task details
Categories and settings
Habits and completions
Integration tokens and credentials

Key Management

Platform	Storage Location
iOS	Secure Enclave / Keychain
Android	Android Keystore
Web	LocalStorage (with additional obfuscation)

Encryption Implementation

// utils/encryptedStorage.ts
import CryptoJS from 'crypto-js';

export const encryptedStorage = {
  async setItem(key: string, value: string): Promise<void> {
    const encryptionKey = await getEncryptionKey();
    const encrypted = CryptoJS.AES.encrypt(value, encryptionKey).toString();
    await AsyncStorage.setItem(key, encrypted);
  },
  
  async getItem(key: string): Promise<string | null> {
    const encrypted = await AsyncStorage.getItem(key);
    if (!encrypted) return null;
    const encryptionKey = await getEncryptionKey();
    const bytes = CryptoJS.AES.decrypt(encrypted, encryptionKey);
    return bytes.toString(CryptoJS.enc.Utf8);
  }
};

Migration Support

The system includes automatic migration from legacy encryption formats, ensuring backward compatibility as encryption methods evolve.

10. Database Schema

Core Tables

users

Column	Type	Description
id	TEXT PK	User identifier
email	TEXT	Email address
name	TEXT	Display name
password_hash	TEXT	PBKDF2 password hash
role	VARCHAR(20)	master, admin, user, viewer
subscription_tier	VARCHAR(20)	free, basic, pro, lifetime
stripe_customer_id	TEXT	Stripe customer ID
referral_code	VARCHAR(10)	Unique referral code
referral_credits	INTEGER	Earned referral credits

user_sessions

Column	Type	Description
id	SERIAL PK	Session ID
user_id	TEXT	Reference to user
session_token	TEXT UNIQUE	256-bit token
expires_at	TIMESTAMP	Expiration time
ip_address	TEXT	Client IP
user_agent	TEXT	Browser/device

payments

Column	Type	Description
id	SERIAL PK	Payment ID
user_id	TEXT	Reference to user
provider	VARCHAR(20)	stripe, app_store, play_store
amount	INTEGER	Amount in cents
subscription_tier	VARCHAR(20)	basic, pro, lifetime
status	VARCHAR(20)	pending, succeeded, failed, refunded

promo_codes

Column	Type	Description
id	SERIAL PK	Promo code ID
code	VARCHAR(50) UNIQUE	Promo code string
code_type	VARCHAR(20)	vip, promo, referral_reward
tier_granted	VARCHAR(20)	basic, pro, lifetime
max_redemptions	INTEGER	Max uses (-1 = unlimited)
expires_at	TIMESTAMP	Expiration date

power_boost_purchases

Column	Type	Description
id	SERIAL PK	Purchase ID
user_id	TEXT	Reference to user
boost_type	VARCHAR(30)	zapier, ai_suggestions, etc.
amount	INTEGER	1000 ($10.00)
status	VARCHAR(20)	active, expired, refunded

Additional Tables

feedback - User feedback and suggestions
smart_tips - AI-generated tips
share_events - Share tracking for referrals
share_rewards - Referral reward claims
progress_snapshots - User progress sharing
user_subscriptions - Subscription history
launch_action_events - Email/call/text tracking
zapier_export_events - Zapier webhook logs
user_metrics - Aggregate user statistics
promo_code_redemptions - Promo code usage
push_notification_logs - Notification history
subscription_cancellations - Churn tracking

11. API Reference

Authentication Endpoints

Endpoint	Method	Auth	Description
/api/auth/register	POST	None	Register new user
/api/auth/login	POST	None	User login
/api/auth/logout	POST	Session	End session
/api/auth/me	GET	Session	Get current user
/api/auth/change-password	POST	Session	Change password
/api/admin/login	POST	None	Admin login

User Endpoints

Endpoint	Method	Auth	Description
/api/user/dashboard	GET	Session	User dashboard stats
/api/user/profile	PUT	Session	Update profile
/api/user/sessions	GET	Session	List user sessions
/api/user/sessions/:id	DELETE	Session	Revoke session

Admin Endpoints

Endpoint	Method	Auth	Description
/api/admin/users	GET	Admin	List all users
/api/admin/users/:id	PUT	Admin	Update user
/api/admin/users/:id	DELETE	Admin	Delete user
/api/admin/feedback	GET	Admin	List feedback
/api/admin/payments	GET	Admin	List payments
/api/admin/subscriptions	GET	Admin	List subscriptions
/api/admin/promo-codes	GET/POST	Admin	Manage promo codes
/api/admin/sessions	GET	Master	All active sessions

Tracking Endpoints

Endpoint	Method	Auth	Description
/api/launch/log	POST	None	Log launch action
/api/launch/stats/:deviceId	GET	None	Get launch stats
/api/zapier/export	POST	None	Export to Zapier
/api/zapier/stats/:deviceId	GET	None	Get Zapier stats
/api/metrics/:deviceId	GET	None	Get user metrics
/api/metrics/increment	POST	None	Increment metric

Payment Endpoints

Endpoint	Method	Auth	Description
/api/stripe/products	GET	None	List products
/api/stripe/checkout	POST	None	Create checkout
/api/stripe/portal	POST	None	Customer portal
/api/stripe/webhook	POST	Signature	Stripe webhooks
/api/referral/register	POST	None	Register referral code
/api/referral/apply	POST	None	Apply referral code

12. User Dashboard

Overview

The User Dashboard is a web-based interface at /dashboard/index.html that provides users with account management, statistics, and self-service capabilities.

Access & Authentication

Users access the dashboard by logging in with their email and password. New users can register directly from the dashboard login page.

        URL: /dashboard/index.html

        Authentication: Email/password with session token

Dashboard Sections

Overview

Dashboard home showing activity summary, user permissions, and key statistics at a glance.

Profile

Manage personal information including name, email (read-only), phone number, and company name.

Subscription

View current subscription tier, expiration date, and complete subscription history with provider details.

Payments

Complete payment history showing date, provider (Stripe/App Store/Play Store), type, tier, amount, and status.

Referrals

View and generate referral codes, track referral credits earned, see people referred, and claim rewards.

Track sharing activity history including channels used and share status.

Progress

View progress snapshots showing tasks completed, streaks, habits, perfect days, and achievements.

Sessions

View all active login sessions with IP address, device info, and ability to revoke sessions.

Security

Change password and manage security settings for the account.

User Dashboard Statistics

The Overview section displays key metrics:

Metric	Description
Tasks Created	Total number of tasks the user has created
Tasks Completed	Total number of tasks marked as complete
Habits Created	Total habits added to 10 for Life
Habits Completed	Total habit completions logged
Total Shares	Number of unique shares sent
Referral Credits	Credits earned from successful referrals

Referral System

Users can earn rewards by referring friends:

Generate Code: Create a unique referral code to share
Track Referrals: See how many people used your code
Earn Credits: Get referral credits for each signup
Claim Rewards: Redeem credits for subscription benefits

Referral Rewards:

10 unique shares = 1 month Basic tier free
20 unique shares = 1 month Pro tier free

Session Management

The Sessions section allows users to:

View all active login sessions
See IP address and device/browser information
Check when each session was last active
Revoke any session (logout remotely)
Current session is highlighted for reference

User Dashboard API Endpoints

Endpoint	Method	Description
/api/user/dashboard	GET	Get dashboard statistics
/api/user/profile	PUT	Update profile information
/api/user/payments	GET	List payment history
/api/user/shares	GET	List share events
/api/user/sessions	GET	List active sessions
/api/user/sessions/:id	DELETE	Revoke a session
/api/user/subscription	GET	Get subscription details
/api/user/referrals	GET	Get referral information
/api/user/referrals/generate-code	POST	Generate referral code
/api/user/snapshots	GET	List progress snapshots

Role-Based Features

Dashboard features vary based on user role:

Feature	Viewer	User	Admin	Master
View Dashboard	Yes	Yes	Yes	Yes
Update Profile	-	Yes	Yes	Yes
Change Password	-	Yes	Yes	Yes
Generate Referral Code	-	Yes	Yes	Yes
Revoke Sessions	-	Yes	Yes	Yes
Access Admin Dashboard	-	-	Yes	Yes

UI Design

The User Dashboard follows a modern dark theme design:

Sidebar Navigation: Fixed left sidebar with user info, navigation menu, and logout button
Stats Cards: Grid of metric cards showing key statistics
Data Tables: Paginated tables for payments, subscriptions, shares, and sessions
Role Badges: Color-coded badges indicating user role and subscription tier
Toast Notifications: Success/error feedback for user actions

Primary
#f97316

Background
#0f172a

Card BG
#1e293b

Text
#f1f5f9

13. Future Upgrades

Planned Features

Power Boosts (Premium Add-ons)

Available Zapier Integration

$10 one-time purchase. Auto-import tasks from external apps via webhooks.

Coming Soon AI Smart Suggestions

$10 one-time purchase. AI-powered task prioritization and scheduling recommendations.

Coming Soon Natural Language Input

$10 one-time purchase. Create tasks using natural language ("Call Mom tomorrow at 3pm").

Coming Soon Smart Task Breakdown

$10 one-time purchase. AI breaks large tasks into smaller, actionable steps.

Integration Roadmap

Integration	Status	Description
Todoist Sync	In Progress	Two-way task sync with Todoist
Google Calendar	Planned	Calendar-based task scheduling
Apple Calendar	Planned	Native iOS calendar integration
Slack	Planned	Task notifications and creation from Slack
Microsoft To Do	Planned	Task import from Microsoft ecosystem
Notion	Planned	Database sync with Notion

Security Enhancements

Two-Factor Authentication (2FA) - Add TOTP-based 2FA for admin accounts
Biometric Authentication - Face ID / Touch ID for app unlock
Session Anomaly Detection - Automatic flagging of suspicious login patterns
Audit Log Export - CSV/JSON export of security audit logs
IP Whitelisting - Restrict admin access to specific IP ranges

Performance Improvements

Offline Mode - Full offline functionality with sync on reconnect
Background Sync - Automatic data sync in background
Push Notification Optimization - Smart batching to reduce battery usage
Image Optimization - Lazy loading and caching for faster load times

Analytics & Insights

Productivity Insights - Weekly/monthly reports on task completion patterns
Habit Analytics - Trend visualization for habit streaks
Time Distribution - Charts showing time spent per category
Prediction Engine - AI-based prediction of task completion likelihood

Platform Expansion

Apple Watch

Quick task completion and habit tracking from your wrist. Complications for active timers.

Android Widgets

Home screen widgets for quick task access and habit check-in.

Desktop App

Native macOS and Windows apps for power users.

Web Dashboard

Full-featured web app for task management and analytics.

Contribution & Feedback: Have ideas for new features or improvements? Submit feedback through the app or contact the development team at feedback@10towin.co or 10towin@voicestamps.com

14. Documentation & Resources

This section provides quick access to all user guides, marketing materials, technical documentation, and reference pages for the 10 to Win ecosystem.

User Guides (Role-Based)

Comprehensive documentation for each access level, available in Markdown and Word-compatible formats.

Guide	Audience	Formats	Description
Master User Guide	Master	.md \| .doc	Complete system access, database operations, all HTML file inventory
Admin User Guide	Admin	.md \| .doc	Dashboard navigation, user management, analytics, bulk operations
User Guide	User	.md \| .doc	Task modes, habit tracking, subscriptions, referral program
Viewer Guide	Viewer	.md \| .doc	Read-only access, viewing capabilities, upgrade path

Marketing & Information Pages

Landing & Overview

Landing Page - Main marketing page
Features & Options - Complete feature list
Plans & Pricing - Subscription tiers
Gamification - Achievement system

User Resources

User Guide - End-user documentation
Feedback Form - Submit feedback
Sign Up - User registration
VIP Program - VIP landing page

Security & Privacy

Privacy & Security - Privacy policy
User Dashboard - Account management

Bug Reporting & Feedback System

10 to Win includes a comprehensive bug reporting and feedback management system accessible to users and administrators.

For Users: Reporting Issues

Users can submit bug reports and feedback through multiple channels:

Feedback Form - Web-based submission with Bug Report or Feature Request options
In-App Links - "Report Bug" links available on Settings, Import, and Habit screens
Email - Direct contact via support@10towin.co

When reporting a bug, include:

Device type (iOS/Android) and version
Steps to reproduce the issue
Expected vs actual behavior
Screenshots if applicable

For Admins: Managing Reports

Administrators manage bug reports through the Admin Dashboard:

Feedback Manager - View, filter, and respond to all submissions
Status Tracking - Mark reports as New, In Progress, Resolved, or Won't Fix
Priority Assignment - Set Low, Medium, High, or Critical priority
Bulk Operations - Process multiple reports simultaneously

Submission Types

Type	Description	Priority Default
Bug Report	Something isn't working correctly	Medium
Feature Request	Suggestion for new functionality	Low
General Feedback	Comments, praise, or general input	Low

Admin Workflow

Review - Check new submissions in Feedback Manager
Triage - Assign priority and category
Investigate - Reproduce issue and identify cause
Resolve - Fix and update status
Notify - Email notification sent to user (if email provided)

Email notifications are sent via Resend integration.

API Endpoint

Bug reports submitted via the feedback form are processed by the backend:

POST /api/feedback
Content-Type: application/json

{
  "type": "bug" | "feature" | "feedback",
  "name": "User Name",
  "email": "user@example.com",
  "message": "Description of the issue..."
}

Admin notifications are sent to configured admin emails via the Resend integration.

Technical Documentation

App Concepts

10 for Life - Habits module overview
App Concept - Detailed habits concept
Task Ranking - Priority algorithm
Smart Mapping - Priority visualization
Development Log - Complete project history with timestamps

Integration Guides

Zapier Integration - Webhook setup
Expo Go Production - Deployment guide
Coding Guide - Technical implementation

Diagrams & Visuals

SVG Diagrams - Visual diagrams
Promo Cards - Printable cards

Marketing Brochures

Printable brochures for different marketing purposes:

Brochure	Link	Focus
Main Brochure	brochure.html	General marketing overview
Feature Focus	brochure2.html	Detailed feature highlights
Benefits Brochure	brochure3.html	User benefits and outcomes
Comparison Brochure	brochure4.html	Tier comparison and pricing
Testimonials	brochure5.html	User testimonials and success stories

Admin & Dashboard Pages

Page	URL	Access Level	Description
Admin Dashboard	/admin/index.html	Admin+	Main admin control panel
Master View	/admin/master-view.html	Master	System-wide analytics and control
Feedback Manager	/admin/feedback.html	Admin+	User feedback management
Session Manager	/admin/SessionManager.html	Admin+	Active session management
User Dashboard	/dashboard/index.html	User+	Self-service account management

Payment Flow Pages

Payment Success

/payment-success.html

Displayed after successful payment completion.

Payment Cancelled

/payment-cancel.html

Displayed when user cancels payment.

Internal Documentation

Document	URL	Description
Project Details	/internal/project-details.html	Internal project documentation and notes
Design Guidelines	/DesignGuidelines.html	This document - comprehensive design reference
Storage Capacity	/StorageCapacity.html	Database limits, storage thresholds, and Enterprise data management
Development Log	/docs/development-log.html	Chronological development changelog and feature tracking
Mobile App Checklist	/docs/mobileappchecklist.html	Feature completeness comparison and implementation status

Quick Reference: For the most comprehensive overview including all HTML files with links and descriptions, see the Master User Guide (Admin Only): .html | .md | .doc (Section 11: Complete HTML File Reference).

10 to Win

Table of Contents

1. Executive Overview

Core Philosophy

Key Modules

10 to Win (Tasks)

10 for Life (Habits)

Subscription Tiers

Admin Dashboard

User Dashboard

Subscription Tiers

Free

Basic

Pro

Lifetime

2. System Architecture

Technology Stack

Navigation Structure

File Structure

3. Design System

iOS 26 Liquid Glass Design

Color Palette

Primary Colors

Light Mode

Dark Mode

Typography Scale

Spacing System

Border Radius

Component Specifications

Task Card

Floating Action Button

Category Badge

4. Task Prioritization System

Priority Score Algorithm

Task Modes

Advanced Factors (Pro-Only)

5. Habits Module (10 for Life)

Core Concept

Habit Types

Yes/No

Quantity

Timed

Streak Milestones

Daily Score & Perfect 10

Streak Protection

Habit Settings

Constants

6. Integrations

Stripe Integration

Configuration

Stripe Service Methods

Webhook Events Handled

Products & Prices

Resend Integration

Email Templates

Zapier Integration

How It Works

API Endpoint

Todoist Integration

Planned Features

Twilio Integration

Capabilities

Integration Architecture

7. Security & Role-Based Access Control

Role Hierarchy

Permission Matrix

Authentication Flow

Password Security

Middleware Functions

Test Users

8. Session Management

Session Properties

Session Lifecycle

User Sessions

Admin Sessions

Admin Session Controls

My Sessions

All Sessions (Master Only)

Session API Endpoints

Security Best Practices