-
Notifications
You must be signed in to change notification settings - Fork 2
Core Features
Matthew Smith edited this page Dec 3, 2025
·
7 revisions
Users can create accounts and authenticate using multiple methods:
- 📧 Email/Password - Traditional authentication with email and password
- 🔵 Google - OAuth integration with Google accounts
- 🪟 Microsoft - OAuth integration with Microsoft accounts
- 🐙 GitHub - OAuth integration with GitHub accounts
- 🍎 Apple - OAuth integration with Apple ID
🌞 / 🌙 Toggle between light and dark theme preferences for comfortable viewing in different environments with automatic theme adaptation throughout the application.
- 📂 Collapsible Sidebar - Minimize sidebar to icon-only view for more workspace
- 🔍 Icon Navigation - Compact mode with helpful tooltips for all sidebar actions
- 🎯 Quick Access - Fast navigation to create, search, and browse features
When creating a new story, users can configure:
- 📝 Story Title - Set the name of your story
- 📄 Story Summary - Add an optional description of your story
- 🎬 Opening Scene Title - Customize the title of your first scene
- 📖 Opening Scene Content - Write the starting content for your story
- 🌍 Make Public - Share your story with the community
- 🔒 Keep Private - Keep your story personal (default)
- 🔍 Search Stories - Find stories by title or summary with real-time search
- 📚 All Stories View - Browse complete story library in modal dialogs
- 🎭 Story Tiles - View stories with title, summary, and action buttons
- 📊 Graph View - Visual representation of story structure and scene connections
- ✏️ Edit View - Detailed editing interface for scenes and content
Interactive Graph Controls:
- 🔍 Zoom In/Out - Precise zoom controls with +/- buttons
- 📊 Zoom Percentage - Click to type custom zoom level (10%-300%)
- 🔄 Reset View - Return to optimal graph fit with one click
- ⌨️ Keyboard Navigation - Arrow keys to pan, +/- to zoom, 0 to reset
- 🖱️ Mouse Controls - Drag to pan, scroll to zoom
- 🎨 Visual Feedback - Hover indicators and smooth transitions
- 🌓 Dark Mode Graphs - Automatic theme adaptation for optimal visibility
Export Options:
- 📋 Copy Mermaid JS - Export story graph code for external use
- ⬇️ Download SVG - Save graph as scalable vector graphic (always exports in light mode for universal compatibility)
Graph Information:
- 🎬 Scene Count - Total number of scenes in story
- ➡️ Path Count - Total number of connections between scenes
Scene Organization:
- 📝 Scene List - Organized view of all scenes with:
- ⭐ Child Scene Indicator - Visual markers for scenes connected to current selection
- 🎯 Scene Selection - Click any scene to view and edit
- 📏 Expandable List - Toggle between compact (default) and full-height views
- 🏠 Root Scene Badge - Visual indicator for story's starting scene
Scene Editing:
- 🏷️ Scene Title - Edit and save scene titles independently
- 📝 Scene Content - Edit scene text with rich text area
- 🖼️ Scene Images - Add visual content to scenes:
- 📤 Upload Image - Add images to any scene (JPG, PNG, GIF, WebP)
- 📏 Size Limit - Maximum 10MB per image
- 👁️ Image Preview - View uploaded images in editor
- 🗑️ Remove Image - Delete images with confirmation
- 🔄 Replace Image - Upload new image automatically replaces old one
- ☁️ Cloud Storage - Images stored securely in Convex storage
- 💾 Separate Save Controls - Save title and content independently
⚠️ Unsaved Changes Warning - Alerts before losing unsaved edits when:- Switching to another scene
- Closing the editor
- Options to save, discard, or cancel
Scene Navigation:
- 🔄 Smart Scene Switching - Click scenes in list to navigate
- 💾 Auto-Save Option - Prompt to save when switching scenes
- ⚡ Quick Access - Direct navigation to connected scenes from path list
Path Management:
- ➡️ Outgoing Choices - View all paths leading from current scene
- 🗑️ Delete Paths - Remove existing story branches with confirmation
- 👁️ Path Preview - See choice labels and destination scenes
- 🎯 Quick Navigate - Click any path to jump to its destination scene
Adding New Content:
- ➕ Add New Scene - Create a new scene with:
- 🏷️ Path Label - The choice text readers will see
- 🎬 Scene Title - Title for the new scene
- 📝 Scene Content - Content for the new scene
- 🔗 Automatic Connection - Creates path from current scene
- 🔗 Link to Existing Scene - Connect current scene to any existing scene in the story
Visual Scene Preview:
- 🗺️ Current Paths Preview - Mini-graph showing:
- 📍 Current Scene - Highlighted with special styling
- ➡️ Connected Scenes - Immediate children with path labels
- 🔒 Conditional Paths - Visual indicators for locked choices
- ⚡ Effect Markers - Indicators for paths with effects
- 🎨 Interactive Graph - Full zoom, pan, and navigation controls
- 📁 Collapsible Section - Toggle to show/hide preview
Core AI Features:
- 💡 Suggest Improvements - Get specific, actionable suggestions with:
- 🎯 Random Aspects - AI analyzes 3 random writing aspects each time
- 📝 Detailed Feedback - Specific suggestions for improvement
- ✨ Revised Example - AI-generated improved version of your text
- 🏷️ Scene Title Suggestion - Recommended title for the scene
- 📊 Analysis - Explanation of improvements made
- ✍️ Rewrite - Generate alternative versions of scene content
- 🎭 Change Tone - Adjust emotional tone (e.g., "horror", "mystery", "comedic")
- 📝 Expand Content - Extend scenes with target length control (e.g., "2-3 paragraphs")
- 💬 Feedback Mode - Interactive chatbot-style guidance with custom feedback
- ➡️ Generate Choices - AI-powered branching storylines with:
- 🏷️ Choice Labels - The text readers see for each option
- 🎬 Scene Titles - Suggested titles for new scenes
- 📖 Scene Descriptions - Opening content for each branch
AI Assistant Controls:
- 📁 Collapse/Expand - Minimize AI panel when not needed
- 🔄 Auto-Refresh - Panel resets when switching scenes
⚠️ API Key Setup - Clear instructions for configuration if needed
Saved Suggestions System:
- 💾 Save AI Content - Save any AI-generated content for later:
- Improvement suggestions with examples
- Generated story choices
- Rewritten content
- Feedback-based revisions
- ✅ Save Confirmation - Visual feedback when content is saved
- 📚 "My Saved" Button - Quick access to saved suggestions library
Apply AI Content:
- ⚡ One-Click Apply - Apply AI suggestions directly to scene editor
- 🎬 Title Integration - Automatically update scene titles from suggestions
- 🔗 Choice Integration - Pre-fill "Add New Scene" form with generated choices
Organization:
- 🗂️ Filter by Type - View saved items by category:
- Improvement suggestions
- Generated choices
- Rewrites
- Enhanced content
- 🔍 Visual Cards - Preview saved content with:
- 🏷️ Type Badge - Color-coded category indicators
- 📅 Creation Date - Timestamp for each saved item
- 📝 Content Preview - First 100 characters of original content
Saved Item Actions:
- 👁️ Detailed View - Click any item to see:
- 📖 Full Original Content
- 💡 Complete Suggestions - All improvement suggestions
- ✨ Revised Text - Full AI-generated improvements
- 🏷️ Suggested Titles - Scene title recommendations
- 📊 Analysis - Detailed explanation of changes
- 🎯 Generated Choices - All choice options with descriptions
- 📋 Copy to Clipboard - Copy any saved content with confirmation
- ⚡ Apply to Editor - Insert saved content into current scene
- 🗑️ Delete - Remove saved items with confirmation dialog
- 📝 Add Notes - Attach personal notes to any saved suggestion
Library Management:
- 🔢 Sorted by Date - Newest items appear first
- 🎯 Context Aware - Filter by current story or scene
- 📊 Statistics - View count of saved items by type
Starting Sessions:
▶️ Start New Session - Begin reading any story from the beginning- 📚 Session History - View all your past play sessions with:
- 📖 Session Tiles - Visual cards for each session
- 🎬 Story Context - See which story each session belongs to
- 🕐 Recent First - Sessions sorted by most recent activity
Interactive Reading:
- 💬 Chat Timeline - Story content displayed as conversation:
- 📖 Narrator Messages - Story content from scenes
- 🖼️ Scene Images - Uploaded images display within story messages
- 👤 User Choices - Your selected paths shown in timeline
- 🎭 Character Messages - Different roles displayed with visual distinction
- 📊 Message Metadata - Author and role information for each message
- 🔄 Loading States - Smooth loading indicators for images
Reading Modes:
- 👆 Manual Mode - Reader controls progression:
- ➡️ Choice Buttons - Select from available story branches
- 🎯 Active Choices - See all available paths at current point
- 📝 Choice Labels - Descriptive text for each option
- ⏩ Auto Mode - Automated story progression:
- 🤖 Automated Advancement - System automatically selects first available choice
- ⏸️ Stop Button - Pause auto-progression at any time
- ⏱️ Timed Delays - Natural pacing between story segments
- 🔄 Auto-Continue - Seamlessly moves through story paths
Session Management:
- 💾 Progress Tracking - Current position saved automatically
- 🎯 Current Choices - Display available options at any point
- ❌ Close Session - End current reading session and return to session list
- 📖 Resume Sessions - Continue from where you left off in any session
⚠️ Unsaved Changes Protection - Warnings before data loss- 🔄 Auto-Retry Logic - Automatic retry for failed operations
- 📝 Error Messages - Clear, actionable error descriptions
- 🛡️ Input Validation - Real-time validation for all user inputs
- 🖼️ Image Upload Validation - File type and size verification with user feedback
- ⚡ Debounced Search - Optimized search with 250ms delay
- 🎯 Lazy Loading - Components load only when needed
- 🔄 Real-Time Sync - Convex real-time database updates
- 💾 Efficient State Management - Optimized React state handling
- ☁️ Secure File Storage - Images stored with signed URLs and automatic cleanup