Skip to content

Repository files navigation

Narrative Exploration

An immersive, gamified educational platform that transforms classic literature into interactive learning experiences. Built with modern web technologies and AI integration, this platform makes literary analysis engaging and accessible for students and teachers alike.

Screenshot 2025-07-24 at 2 19 45 PM

🎯 Mission

Take long-form narrative, distill it into important quotes, visuals, structural elements, syntax, and teach it in a short-form medium through interactive, gamified experiences.

✨ Features

For Students

  • Interactive Literary Modules: Dive into classic works like Moby Dick, Animal Farm, Crime and Punishment, and more
  • Gamified Learning: Complete quests, earn achievements, and track progress through engaging challenges
  • Visual Learning: Rich imagery, 3D elements, and interactive components enhance understanding
  • Study Guides: Comprehensive resources for deeper literary analysis
  • Quizzes: Test knowledge and reinforce learning objectives
  • Character Exploration: Interactive character studies and relationship mapping

For Teachers

  • Analytics Dashboard: Track student progress and engagement metrics
  • Student Success Monitoring: Comprehensive tools for monitoring individual and class performance
  • Pedagogical Resources: Teaching guides and curriculum integration tools
  • Assessment Tools: Built-in quiz and evaluation systems

For Everyone

  • Socratic Forum: Interactive discussion spaces for literary discourse
  • Glossary: Comprehensive literary terms and concepts
  • Story Worlds: Immersive environments for each literary work
  • The Arena: Competitive learning challenges and debates

🛠 Technology Stack

  • Framework: Next.js 14 with App Router
  • Language: TypeScript
  • Styling: Tailwind CSS with custom components
  • 3D Graphics: Three.js with React Three Fiber
  • Animations: Framer Motion
  • AI Integration: Echo SDK
  • UI Components: Custom built with shadcn/aceternity patterns

🚀 Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

  1. Clone the repository:
git clone <repository-url>
cd narrative-exploration
  1. Install dependencies:
npm install
  1. Set up environment variables:
cp .env.example .env.local

Add your OpenAI API key to .env.local:

OPENAI_API_KEY=your_api_key_here
  1. Run the development server:
npm run dev
  1. Open http://localhost:3000 in your browser.

📚 Available Literary Modules

  • Moby Dick - Herman Melville's maritime masterpiece
  • Animal Farm - George Orwell's political allegory
  • Crime and Punishment - Fyodor Dostoevsky's psychological drama
  • Pride and Prejudice - Jane Austen's romantic comedy
  • Their Eyes Were Watching God - Zora Neale Hurston's coming-of-age story
  • Things Fall Apart - Chinua Achebe's postcolonial narrative

Each module includes:

  • Interactive journey through the narrative
  • Character analysis and relationship mapping
  • Thematic exploration with visual aids
  • Study guides and supplementary materials
  • Knowledge assessment quizzes

🎨 Design Philosophy

The platform embraces a cozy bookstore aesthetic with warm, inviting colors and textures that evoke the feeling of being in a beloved local bookstore. The design emphasizes:

  • Accessibility: Clear navigation and readable typography
  • Immersion: Rich visual storytelling and atmospheric elements
  • Gamification: Progress tracking and achievement systems
  • Responsiveness: Seamless experience across all devices

🤝 Contributing

We welcome contributions! Please see our contributing guidelines for details on:

  • Code style and standards
  • Testing requirements
  • Pull request process
  • Development setup

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Built with love for literature and education
  • Inspired by the timeless works of classic authors
  • Designed to make learning engaging and accessible for all students

"The unexamined life is not worth living" — Socrates

About

Making long form narratives available in contemporary short forms

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages