An intelligent story generator that crafts evolving narratives in real-time, maintaining character arcs and plot continuity across unlimited chapters.
Illude isn't just another AI writing tool. It's a living story ecosystem that:
- 🧠 Remembers Everything - Advanced memory system tracks plot points, character development, and story continuity
- 🎨 Evolves Naturally - Each chapter builds meaningfully on previous events
- 🤝 Collaborative Creation - Choose between AI-driven narrative flow or direct your story's path
- 💾 Never Lose Progress - All stories are safely stored in MongoDB with full history
- 🎭 Rich Character Development - Watch your characters grow and change across chapters
- ⚡ Instant Generation - Powered by Google Gemini 2.5 Flash for lightning-fast story creation
- Story Dashboard - Beautiful grid view of all your stories with status tracking
- Multi-Chapter Narratives - Unlimited chapter generation with perfect continuity
- Character Arc Tracking - AI monitors and develops character growth over time
- Plot Memory System - Maintains consistency across complex storylines
- Dual Generation Modes:
- 🎯 AI Direction - Let AI naturally progress your story
- ✍️ User Direction - Provide specific instructions for story development
- Context-Aware Writing - AI considers all previous chapters and character states
- Automatic Chapter Analysis - Every chapter is analyzed for key events and plot developments
- Dark Theme with elegant emerald accents
- Responsive Design - Perfect on desktop and mobile
- Intuitive Navigation - Seamlessly move between stories and chapters
- Real-time Updates - Watch your stories come to life instantly
- Character Profiles - Detailed character creation with relationships and backgrounds
- World Systems - Magic systems, technology, power structures, and more
- Cultural Elements - History, lore, mythology, and cultural details
- Setting Management - Rich environmental and location descriptions
- Next.js 15.3.5 - React framework with App Router
- TypeScript - Type-safe development
- Tailwind CSS - Utility-first styling
- Radix UI - Accessible component primitives
- Lucide React - Beautiful icon library
- Next.js API Routes - Serverless backend functions
- MongoDB - Document database for story persistence
- Mongoose - ODM for MongoDB integration
- Google Gemini 2.5 Flash - Advanced language model for story generation
- Smart Prompting - Context-aware prompt engineering for consistency
- Node.js 18+
- MongoDB database (local or cloud)
- Google Gemini API key
-
Clone the repository
git clone https://github.com/mansi0xc/illude.git cd illude/client -
Install dependencies
npm install
-
Set up environment variables
# Create .env.local file cp .env.example .env.localAdd your configuration:
MONGODB_URI=your_mongodb_connection_string GEMINI_API_KEY=your_google_gemini_api_key
-
Run the development server
npm run dev
-
Open your browser Navigate to http://localhost:3000
- Click "Start Creating" on the homepage
- Fill in your story details:
- Basic Info: Title, description, plot, and central conflict
- Characters: Detailed character profiles with goals and relationships
- World Building: Settings, magic systems, rules, and lore
- Generate your first chapter automatically
- Visit "My Stories" to see all saved stories
- Click "Continue Story" to add new chapters
- Choose your generation mode:
- 🤖 AI Direction: Let AI naturally progress the story
- ✍️ Your Direction: Tell AI exactly what should happen next
- Read Full Stories with beautiful chapter navigation
- View Story Memory to see plot points and character arcs
- Track Character Development across chapters
- Delete or Archive completed stories
Illude's revolutionary memory system ensures perfect story continuity:
- 📊 Plot Points - Key story developments and turning points
- 👥 Character Arcs - Individual character growth and changes
- 🌍 World State - Current state of your story world
- ⚔️ Active Conflicts - Ongoing tensions and problems
- 🔍 Mysteries - Unresolved elements to address later
- 🔮 Foreshadowing - Elements to pay off in future chapters
- 💕 Relationships - Character interactions and bonds
- Chapter Generation - AI writes new chapter with full context
- Automatic Analysis - AI analyzes chapter for key elements
- Memory Update - Story memory is updated with new information
- Future Reference - All future chapters use this accumulated knowledge
Elegant dark theme with emerald accents showcasing Illude's capabilities
Comprehensive form for creating rich, detailed stories with dynamic character and world-building sections
Beautiful grid layout showing all your stories with status indicators and quick actions
Immersive reading experience with chapter navigation and expandable story details
Split-view interface for generating new chapters with memory context and real-time preview
illude/
├── client/ # Next.js application
│ ├── app/ # App Router pages
│ │ ├── api/ # API routes
│ │ │ ├── stories/ # Story CRUD operations
│ │ │ │ └── initStory/ # Initial story generation
│ │ │ └── stories/ # Story management pages
│ │ │ ├── [id]/ # Individual story pages
│ │ │ │ ├── continue/ # Story continuation
│ │ │ │ └── page.tsx # Story reader
│ │ │ └── page.tsx # Stories dashboard
│ │ ├── story-generator/ # Story creation
│ │ └── page.tsx # Landing page
│ ├── components/ # Reusable UI components
│ ├── functions/ # Utility functions
│ ├── lib/ # Database and utilities
│ │ ├── mongodb.ts # MongoDB connection
│ │ └── models.ts # Database schemas
│ └── package.json
└── README.md
GET /api/stories- Get all storiesPOST /api/stories- Create new storyGET /api/stories/[id]- Get specific storyPUT /api/stories/[id]- Update storyDELETE /api/stories/[id]- Delete story
POST /api/stories/[id]/chapters- Generate new chapter{ "generateType": "ai" | "user-directed", "userDirection": "Optional direction for the story" }
POST /api/initStory- Generate first chapter and create story{ "story": { "title": "Story Title", "description": "Story description", "characters": [...], "settings": "Story setting", // ... other story properties } }
Try Illude with this ready-to-use story concept:
Genre: Sci-Fi Fantasy
Setting: Memoriam - floating city where memories are currency
Protagonist: Kira Ashwind - memory thief seeking the legendary "First Memory"
Conflict: Must choose between power and protecting reality itself
Perfect for testing multi-chapter generation and memory continuity!
We welcome contributions! Here's how you can help:
- 🐛 Report Bugs - Use GitHub issues for bug reports
- 💡 Suggest Features - Share your ideas for improvements
- 🔧 Submit PRs - Help improve the codebase
- 📖 Improve Docs - Help make the documentation better
- Use TypeScript for type safety
- Follow the existing code style
- Add JSDoc comments for functions
- Test your changes thoroughly
- ✅ AI-powered story generation
- ✅ MongoDB story persistence
- ✅ Multi-chapter continuity
- ✅ Advanced memory system
- ✅ Beautiful responsive UI
- ✅ Character arc tracking
- 🔊 Audio Generation - Text-to-speech for chapters
- 🎨 Image Generation - AI-generated story illustrations
- 👥 Collaborative Stories - Multi-user story creation
- 📱 Mobile App - Native iOS/Android experience
- 🌐 Story Sharing - Public story gallery
- 🎯 Genre Templates - Pre-built story frameworks
This project is licensed under the MIT License - see the LICENSE file for details.
- Google Gemini - For powerful AI story generation
- Next.js Team - For the amazing React framework
- Tailwind CSS - For beautiful, utility-first styling
- MongoDB - For reliable data persistence
- Radix UI - For accessible component primitives
- Lucide - For beautiful, consistent icons
"Every great story begins with a single word. Let Illude help you find yours." ✨