The Ultimate Cross-Platform Worldbuilding App for Writers, Game Masters, and Creators
Version 1.0.17 - Drawer Navigation with Enhanced Mobile Experience
LoreWeaver is a comprehensive worldbuilding application that combines powerful organizational tools with AI assistance to help you create rich, detailed fictional worlds. Whether you're writing a novel, designing a game campaign, or building a universe for any creative project, LoreWeaver provides everything you need in one integrated platform.
🆕 What's New in v1.0.17:
- ✅ Modern Drawer Navigation: Complete overhaul from tab-based to hamburger menu navigation
- ✅ 26 Specialized Screens: Comprehensive worldbuilding categories including Natural Laws, Ecosystems, Technology
- ✅ Enhanced Mobile Experience: Gesture-based drawer navigation optimized for touch devices
- ✅ Improved Organization: Cleaner file structure with all screens properly organized
- ✅ Fresh Build System: Rebuilt with latest React Navigation components and Expo Router
Supported Platforms:
📱 Android • 🍎 iOS • 🪟 Windows • 🍎 macOS • 🐧 Linux • 🌐 Web • ⚡ PWA
- 🎯 Complete Worldbuilding Suite - 26 specialized screens accessible via modern drawer navigation
- 🤖 AI-Powered Enhancement - AI Ideas Generator works globally or with world context
- 📱 Cross-Platform Optimized - Responsive design for phones, tablets, and web with rotation support
- 🔄 Offline Core Features - Core worldbuilding works without internet (AI features require connection)
- 💾 Local Storage - All data stored securely on your device
- 🎨 Beautiful UI - Modern, intuitive interface with multiple themes and font customization
- 🔗 Smart Linking - Automatic cross-references between all world elements
- 📊 Visual Tools - Relationship networks, timelines, and interactive maps
- 📤 Professional Export - JSON and Markdown export formats
- 🌍 Consistent World Selection - Unified "Select World" experience across all screens
Create detailed character profiles with comprehensive tracking:
- Character Creation: Name, role, traits, appearance, backstory
- Relationship Mapping: Define connections between characters
- Faction Associations: Link characters to organizations
- Location Connections: Track where characters live and visit
- AI Portrait Generation: Generate character artwork
- Voice Patterns: AI-generated character-specific speech
- Cross-References: Auto-linking mentions across your world
Build immersive places and environments:
- Location Builder: Detailed descriptions and significance
- Location Types: Cities, forests, dungeons, and custom categories
- Interactive Maps: Visual location mapping with coordinates
- Connected Geography: Link locations for world navigation
- Inhabitant Tracking: Know who lives where
- AI Artwork: Generate location illustrations
- Environmental Details: Weather, climate, atmosphere
Design organizations, governments, and groups:
- Organization Management: Guilds, governments, cults, companies
- Ideology & Goals: Define beliefs and objectives
- Leadership Hierarchy: Organizational structure and roles
- Member Management: Track faction members and positions
- Alliance System: Define relationships between factions
- Government Templates: Pre-built political systems
- Conflict Mapping: Track ongoing tensions and wars
Create magical artifacts and important objects:
- Magical Items: Weapons, armor, artifacts, trinkets
- Item History: Track previous owners and events
- Power Descriptions: Define abilities and limitations
- Current Owner: Know who possesses each item
- Item Categories: Organize by type and rarity
- Legendary Templates: Pre-built legendary item concepts
Design comprehensive magic frameworks:
- Magic System Designer: Rules, limitations, and mechanics
- Magic Schools: Different types and disciplines
- Practitioner Tracking: Who can use which magic
- Artifact Integration: Link magical items to systems
- Hard vs Soft Magic: Framework templates
- Spell Database: Catalog of spells and abilities
Build pantheons and belief systems:
- Pantheon Builder: Gods, deities, divine beings
- Religion Designer: Belief systems and organizations
- Ritual Tracker: Religious practices and ceremonies
- Holy Texts: Sacred documents and scriptures
- Follower Management: Track religious adherents
- Divine Relationships: Map deity interactions
- Mythology Database: Pre-built mythological elements
Organize your world's history:
- Interactive Timeline: Visual timeline with multiple zoom levels
- Event Management: Historical events with significance levels
- Parallel Timelines: Multiple timelines for different regions
- Timeline Branching: Alternate histories and "what-if" scenarios
- Era Organization: Group events into historical periods
- Auto-linking: Automatic connections to entities
- Event Categories: Wars, discoveries, births, deaths, and more
Manage world knowledge and background:
- Lore Notes: Detailed world background information
- Category Organization: Tags and categories for organization
- Entity Linking: Connect lore to characters, locations, etc.
- Research Integration: Import and organize research materials
- Consistency Checker: AI-powered contradiction detection
- Lore Templates: Pre-built frameworks for different genres
- Interactive Graphs: Visual network of all entity connections
- Relationship Strength: Visual intensity indicators
- Conflict Mapping: Highlight tensions and alliances
- Family Trees: Specialized family relationship views
- Organizational Charts: Faction structure visualization
- Dynamic Changes: Track relationship evolution over time
- Auto-linking: Automatic detection of entity mentions
- Bidirectional References: See what references each entity
- Dependency Tracking: Understand entity relationships
- Consistency Warnings: AI-powered contradiction detection
- Reference Types: Mentioned, related, dependent, conflicted
- Multi-criteria Search: Search across all entities and content
- Tag-based Organization: Flexible tagging system
- Smart Filters: Filter by type, relationships, tags
- Search History: Track and revisit previous searches
- Saved Searches: Save frequently used search criteria
- AI Ideas Generator: Generate creative ideas with or without world context
- Works globally (no world required) or with world-specific context
- 14 idea categories: Story concepts, characters, plot hooks, titles, etc.
- Genre-aware suggestions (40+ genres supported)
- Author influence system for style inspiration
- Custom prompts for specific requirements
- World Consistency Checker: AI analyzes for contradictions
- Character Generation: Complete character profiles with AI
- Location Creation: Detailed locations with AI assistance
- Item Generation: Magical items with powers and backstories
- Name Generator: Context-appropriate names for all entity types
- Content Enhancement: AI suggestions for improvements
- Genre Templates: High fantasy, space opera, urban fantasy
- Character Archetypes: Pre-filled character traits and roles
- Government Structures: Various political systems
- Magic Frameworks: Hard vs soft magic guidelines
- Cultural Templates: Pre-built cultural frameworks
- Series Creation: Manage multiple book series within worlds
- Book Tracking: Individual book management with status
- Chapter Organization: Detailed chapter management
- Outline Tools: Story and chapter outline creation
- Word Count Tracking: Progress tracking for writing
- Status Management: From planning to published
- WYSIWYG Editor: Rich text editing for all content
- Formatting Options: Bold, italic, lists, headers
- AI Writing Assistant: AI-powered content generation
- Chapter Generator: AI-assisted chapter creation
- Content Templates: Pre-built content structures
- PDF World Bible: Professional world documentation
- Campaign Integration: Export to Roll20, Foundry VTT
- Novel Writing: Export for writing applications
- JSON Export: Complete world data export
- DOCX Import: Import existing documents and novels
- Multi-format Support: Various import/export formats
- DOCX Novel Import: Upload completed novels for analysis
- World Component Extraction: AI extracts characters, locations
- Multi-book Series: Combine multiple novels into one world
- Automatic Entity Creation: AI creates world entities from content
- Plot Point Extraction: Identify key story elements
- Voice Capture: Voice-to-text for rapid idea capture
- Quick Entry: Fast entity creation on mobile
- Offline Mode: Full functionality without internet
- Touch-Optimized UI: Mobile-friendly interface design
- Responsive Layout: Adapts to different screen sizes
- Voice Note Capture: Record and transcribe voice notes
- Speech-to-Text: Convert audio to text for all content
- AI Transcription: Accurate transcription with multiple languages
- Audio Playback: Play back recorded voice notes
- Theme Customization: Dark/light mode with custom themes
- Typography Settings: Font family, size, and line height
- Font Support: System fonts and premium options
- AI Configuration: Multiple AI provider support
- Offline Mode: Work without internet with local storage
- Auto-save: Automatic saving of all changes
- Backup & Sync: Data backup and synchronization
Free AI Providers Included:
- Rork AI: Free tier with GPT-4o-mini, DALL-E 3, Whisper
- Hugging Face: Open source models with generous limits
- Groq: Ultra-fast inference with free tier
- Cohere: Free trial with good limits
- Together AI: Open source models with free credits
- Fireworks AI: Fast inference with free tier
- Perplexity: Search-augmented AI with free tier
- Mistral AI: European AI with free tier
- Google AI: Gemini models with free tier
- DeepSeek: Chinese AI models with free access
- Ollama: Run AI models locally (completely free)
- LM Studio: Local AI inference (completely free)
Premium Options:
- OpenAI: GPT models (requires paid account)
- Anthropic: Claude models (limited free tier)
- Replicate: Pay-per-use with free credits
- Campaign Export: Export worlds for tabletop RPGs
- Roll20 Integration: Direct export to Roll20 platform
- Foundry VTT Support: Export for Foundry Virtual Tabletop
- NPC Management: Detailed NPC creation and management
- Adventure Hooks: AI-generated adventure ideas
- Campaign Notes: Session and campaign planning tools
- Entity Statistics: Count and analyze world entities
- Relationship Analysis: Understand connection patterns
- Content Metrics: Track world building progress
- Completion Status: See what areas need development
- Growth Tracking: Monitor world expansion over time
- Local Storage: All data stored locally on device
- Privacy Protection: No data sent to external servers (except AI features)
- Secure Key Management: Multi-layer API key obfuscation system
- Backup Options: Multiple backup and export options
- Data Portability: Easy export and migration of world data
- Version Control: Track changes and revisions
- Error Recovery: Comprehensive crash logging and error boundaries
LoreWeaver includes a comprehensive crash logging system that automatically captures and logs all errors, crashes, and issues for easy debugging and troubleshooting.
✅ Fatal Crashes - App-ending errors that cause the application to crash
✅ JavaScript Errors - Runtime exceptions and errors that don't crash the app
✅ Console Warnings - Performance warnings, deprecated API usage
✅ Console Errors - Caught exceptions, validation errors
✅ Network Failures - API timeouts, connection issues, 404 errors
✅ Performance Issues - Slow renders, memory warnings
✅ React Component Errors - Component lifecycle errors, hook violations
✅ Unhandled Promise Rejections - Async operation failures
✅ Native Platform Errors - Android/iOS specific crashes
File Locations (Automatically Created):
- Android:
/Android/data/com.lightwraith8268.loreweaver/files/crash-logs/ - iOS:
Documents/crash-logs/ - Web: Browser storage (no files)
Generated Files:
- Individual Crash Files:
crash-{timestamp}-{id}.logwith full details - Master Summary Log:
crash-log-master.logwith all crashes summary
Each crash log includes:
========== ERROR LOG ==========
ID: crash_20241211_143052_abc123
Timestamp: 2024-12-11T14:30:52.123Z
Severity: error | warning | fatal | info
Category: crash | error | network | performance | react
--- ERROR DETAILS ---
Type: TypeError
Message: Cannot read property 'map' of undefined
Stack Trace: [Complete JavaScript stack trace]
--- ENVIRONMENT ---
Platform: android
Build Type: preview | development | production
App Version: 1.0.9
Build Number: 9
--- DEVICE INFO ---
Model: Samsung Galaxy S21
Manufacturer: Samsung
System Version: Android 12
Memory Usage: [Available if supported]
--- ERROR CONTEXT ---
[Additional context and debugging information]
Severity Levels:
- 🔴 Fatal: App-ending crashes that require restart
- 🟠 Error: Serious errors that affect functionality
- 🟡 Warning: Issues that don't break functionality but should be addressed
- 🔵 Info: Informational logging for debugging
Categories:
- 💥 Crash: Fatal application crashes
⚠️ Error: JavaScript runtime errors⚠️ Warning: Performance warnings, deprecated features- 🌐 Network: API failures, timeout errors
- ⚡ Performance: Slow operations, memory issues
- ⚛️ React: Component errors, hook violations
LoreWeaver includes a Crash Test Component accessible from Settings:
Available Test Types:
- 🔴 JavaScript Error: Test basic error logging
- ⚡ Reference Error: Test undefined variable errors
- 🔄 Async Error: Test promise rejection logging
- 🟡 Warning Messages: Test non-fatal warning logging
- 🌐 Network Error: Test network failure logging
- ⚡ Performance Issues: Test performance warning logging
- 📱 Console Messages: Test console interception
On Mobile Devices:
- Connect device to computer via USB
- Enable file transfer mode
- Navigate to app's document directory
- Find
crash-logs/folder - Copy log files for analysis
Alternative Methods:
- Export via Settings: Use app's export feature to save logs
- Email Logs: Share individual log files via email
- Cloud Storage: Upload logs to Google Drive, Dropbox, etc.
Automatic Features:
- Directory Creation: Log directory created automatically on app start
- File Organization: Separate file for each crash with timestamps
- Master Summary: Combined log with all crashes for quick overview
- No Size Limits: Logs continue until storage space runs out
Manual Management:
// Clear all crash log files
import { clearLogFiles } from '@/utils/crash-logger';
await clearLogFiles();
// Get log directory path
import { getLogFilesDirectory } from '@/utils/crash-logger';
const logPath = await getLogFilesDirectory();What's Logged:
- Error messages and stack traces
- Device information (model, OS version)
- App version and build information
- Performance metrics
- User actions that led to errors (anonymized)
What's NOT Logged:
- Personal data or world content
- API keys or sensitive credentials
- User location or tracking data
- Private user information
- World building content
Data Storage:
- Completely Local: All logs stored on device only
- No Cloud Upload: Logs never sent to external servers
- User Controlled: You decide when to share or export logs
- Easy Cleanup: Clear logs anytime through app settings
Custom Error Logging:
import { logError, logWarning, logNetworkError, logPerformanceIssue } from '@/utils/crash-logger';
// Log custom errors
await logError(new Error('Custom error'), { context: 'user action' });
// Log warnings
await logWarning('Performance degradation detected', { renderTime: 2500 });
// Log network issues
await logNetworkError('https://api.example.com', error, { timeout: 30000 });
// Log performance issues
await logPerformanceIssue('Slow component render', { component: 'WorldView' });Integration with Error Boundaries:
- Automatic React component error capture
- Enhanced error context with component information
- Fallback UI display with error reporting options
-
Download & Install
- Android: Install APK file directly or from app store
- iOS: Download from App Store or TestFlight
- Web: Visit the web app in your browser
- Desktop: Download installer for Windows/Mac/Linux
-
Create Your First World
- Choose from genre templates or start from scratch
- Give your world a name and select a genre
- Start with the basics: characters and locations
-
Build Your World
- Add core elements: characters, locations, factions
- Use AI assistance for generating content and ideas
- Connect entities with relationships
- Expand gradually with magic systems, lore, and timeline
- Start Small: Begin with core elements and expand gradually
- Use AI Ideas Generator: Generate inspiration even without a world selected
- Cross-Reference: Take advantage of automatic linking between entities
- Regular Backups: Export your world data regularly (JSON format recommended)
- Explore AI Features: Use AI to enhance and expand your world
- Sync Across Devices: Use Firebase sync to access worlds on multiple devices
Local Storage (Default):
- ✅ All worlds saved locally on your device
- ✅ Instant auto-save - changes saved immediately
- ✅ Works completely offline for all worldbuilding features
- ✅ Complete privacy - data stays on your device
- ✅ Fast performance - no network delays
Firebase Cloud Sync (Optional):
- ✅ Cross-device access - access worlds on all your devices
- ✅ Automatic backup - your worlds are safely backed up in the cloud
- ✅ Real-time sync - changes sync instantly across devices
- ✅ Sign in once - access your worlds anywhere
- ✅ Choose what to sync - keep some worlds local, others synced
Everything Works Offline:
- ✅ All worldbuilding tools (Characters, Locations, Factions, etc.)
- ✅ Content creation and editing
- ✅ Search and filtering
- ✅ Templates and frameworks
- ✅ Import/export features
- ✅ All navigation and UI features
- ✅ Local data storage and retrieval
What Requires Internet:
- ❌ AI features - Content generation, ideas, consistency checking
- ❌ Firebase sync - Cross-device synchronization
- ❌ Voice-to-text - Cloud-based transcription
- ❌ Image generation - AI-powered artwork creation
Note: Local AI providers (Ollama, LM Studio) run offline but may require internet for initial model downloads.
Enable Firebase Sync:
- Go to Settings > Account & Sync
- Sign in with Google, Apple, or email
- Choose sync options for each world
- Access from any device with the same account
Sync Options:
- 📱 Local Only: World stays on this device only
- ☁️ Cloud Sync: World syncs across all your devices
- 📤 Backup Only: World backed up to cloud but not actively synced
Q: Can I use my own AI API keys? A: Yes! The app includes:
- 15+ Free AI providers with pre-configured demo keys (see AI Provider section above)
- Settings to add your own keys for premium providers like OpenAI, Anthropic
- Local AI support (Ollama, LM Studio) - completely free
- Automatic fallback between providers for reliability
Q: Why is LoreWeaver optimized for Android? A: LoreWeaver v1.0.9+ includes specific Android optimizations:
- Android SDK 34: Latest Android 14 compatibility and features
- APK Size Optimization: Smaller download and install size
- Performance Tuning: Optimized for Android runtime and memory management
- Enhanced Crash Logging: Detailed error logs saved to device storage
- Build System: Streamlined Android development and deployment process
Q: How do I access crash logs on Android? A: Multiple methods available:
# Via USB Connection
1. Connect Android device to computer
2. Enable "File Transfer" mode
3. Navigate to: /Android/data/com.lightwraith8268.loreweaver/files/crash-logs/
4. Copy .log files for analysis
# Via File Manager App
1. Open device's file manager
2. Navigate to app data directory
3. Find crash-logs folder
4. Share/export log filesQ: What Android permissions does LoreWeaver need? A: Minimal permissions for privacy:
- ✅ Internet: For AI features and content generation
- ✅ Network State: To detect connectivity for AI features
- ✅ Storage Access: To save worlds and crash logs
- ❌ No Camera: Camera permission blocked
- ❌ No Location: Location tracking blocked
- ❌ No Microphone: Audio recording blocked (unless explicitly needed)
Q: Can I run LoreWeaver offline on Android? A: Yes! Core functionality works completely offline:
- ✅ All worldbuilding tools (Characters, Locations, Factions, etc.)
- ✅ Data storage and retrieval
- ✅ Import/export features (local files)
- ✅ Crash logging (saved locally)
- ❌ AI features require internet for cloud API access
Q: How much storage does the app use? A: Very efficient:
- App size: 30-150MB depending on platform
- World data: Stored locally, typically 1-10MB per world
- No cloud storage - everything stays on your device
- Unlimited worlds - only limited by device storage
Q: Where is my world data stored? A:
- Local storage (default): Saved securely on your device
- Firebase sync (optional): Synced across all your devices in the cloud
- Export anytime to JSON or Markdown files for backup
- You choose: Keep worlds local-only or enable cloud sync per world
Q: Can I sync between devices? A: Yes! LoreWeaver includes Firebase cloud sync:
- Enable sync in Settings > Account & Sync
- Sign in once to access worlds on all your devices
- Choose per world: Keep some local, sync others to cloud
- Real-time sync: Changes appear instantly on other devices
- Automatic backup: Synced worlds are backed up in Firebase
Q: What if I lose my device? A:
- Firebase sync: Synced worlds are automatically backed up and recoverable
- Local worlds: Export regularly to JSON files as backup
- Sign in anywhere: Access synced worlds from any new device
- Export options: Always available for additional backup security
Problem: App crashes on startup Solutions:
- Clear app data and restart
- Check device storage - ensure sufficient space
- Update to latest version of the app
- Check error logs in Settings > Crash Reporting
- Try creating new world to test basic functionality
Problem: AI features not working Solutions:
- Check internet connection - All AI features require internet (except local providers)
- Verify API keys in Settings > AI Providers
- Try different AI provider - 15+ providers available
- Check free tier limits - some providers have daily/monthly quotas
- Use local AI (Ollama, LM Studio) - runs offline after initial setup
Problem: Data not saving Solutions:
- Check device storage - ensure sufficient space available
- Try manual export to test if data persistence works
- Restart app - force close and reopen
- Clear browser cache (web version only)
- Check app permissions for storage access
Problem: Performance issues Solutions:
- Reduce world size - export and split large worlds
- Clear app cache periodically
- Close other apps to free up memory
- Restart device if performance degrades
- Use web version on lower-end mobile devices
Problem: Sync not working between devices Solutions:
- Check internet connection on both devices
- Verify same account - ensure signed in with same Google/Apple/email account
- Enable sync in Settings > Account & Sync for specific worlds
- Wait a moment - sync can take 10-30 seconds for large worlds
- Force sync by making a small edit and saving
- Check world settings - ensure world is set to "Cloud Sync" not "Local Only"
Problem: Can't find my worlds after signing in Solutions:
- Check sync status - worlds may still be syncing from cloud
- Verify account - ensure using exact same sign-in method (Google, Apple, or email)
- Wait for sync - first sync can take several minutes
- Check world list - scroll down, worlds may be at bottom
- Import backup - if you have exported JSON files, use Import feature
Problem: App taking up too much storage Solutions:
- Export old worlds to JSON and delete from app
- Clear crash logs in Settings if they've accumulated
- Delete unused worlds you no longer need
- Use cloud sync to keep worlds in cloud instead of locally
- Clear app cache through device settings
Android (Primary Platform):
- Installation: Enable "Install from Unknown Sources" for APK sideloading
- Device Compatibility: Requires Android 6.0+ (API 23+), Optimized for Android 14 (API 34)
- Storage Requirements: 150MB for app + space for crash logs
- Crash Logs Location:
/Android/data/com.lightwraith8268.loreweaver/files/crash-logs/ - Performance: Optimized specifically for Android devices
- Permissions: Uses minimal required permissions (Internet, Storage access)
- Common Issues:
- If APK won't install: Check "Install from Unknown Sources" in Security settings
- If app crashes: Check crash logs in file manager at crash-logs location
- If slow performance: Close background apps and restart device
iOS:
- Requires iOS 11.0+ for compatibility
- TestFlight for beta testing
- App Store for official releases
Desktop:
- Windows: Download and run the installer (.exe or .msi)
- macOS: Download and open the .dmg file
- Linux: Download .AppImage or .snap file
Problem: Web app not loading Solutions:
- Clear browser cache and reload
- Try different browser - modern browsers required
- Check JavaScript enabled in browser settings
- Disable ad blockers that might block functionality
- Use incognito/private mode to test without extensions
Problem: PWA installation not working Solutions:
- Use supported browser (Chrome, Edge, Safari, Firefox)
- Access via HTTPS - required for PWA features
- Look for install prompt in address bar
- Manual install via browser menu > "Install app"
When reporting issues, please include:
- Platform and version (Android 12, Windows 11, etc.)
- App version and build type (APK, web, desktop)
- Steps to reproduce the problem
- Error messages or crash logs if available
- Device specifications (RAM, storage space)
Where to Find Help:
- Settings > Crash Test: Test crash logging functionality
- Settings > Export Data: Export worlds and crash logs
- Crash Logs: Automatically generated for debugging (Android/iOS only)
- Documentation: Comprehensive guides and tutorials
- Error Reporting: Built-in crash reporting and logging
- Settings: Extensive customization options
- Export Options: Multiple ways to backup your data
- Regular Backups: Export your world data frequently
- Use Auto Save: Keep auto save enabled for important work
- Organize with Tags: Use tags and categories for better organization
- Cross-Reference: Take advantage of automatic entity linking
- Start Simple: Begin with core elements and expand gradually
This app is designed to be the ultimate tool for worldbuilders, combining the power of AI with intuitive design to help you create rich, detailed fictional worlds. Whether you're a novelist, game master, or creative writer, LoreWeaver provides everything you need to bring your imagination to life.
Ready to build your world? Start creating today! 🌟