EduStory: Story-Driven Learning

EduStory is an educational platform designed to transform complex topics into immersive narrative experiences. The project focuses on "Story-Driven Learning," using narrative structures to make educational content more engaging and memorable.

Core Features

• Narrative Generation: Converts topics into age-appropriate stories using natural language models.
• Audio Integration: Features high-fidelity story narration via ElevenLabs.
• Knowledge Assessment: Generates interactive quizzes based on story content to validate learning.
• Claymorphism UI: A custom, tactile design system built for a premium user experience.
• Authentication: Secure user accounts and data persistence via NextAuth and MongoDB.

Tech Stack

Frontend

• Framework: Next.js 15+ (App Router)
• Library: React 19
• Styling: Tailwind CSS 4
• Animations: Framer Motion
• Icons: Lucide React

Backend & Database

• Runtime: Node.js
• Database: MongoDB Atlas
• ORM: Mongoose
• Auth: NextAuth.js

AI & APIs

• LLM: Hugging Face Inference API
• Voice: ElevenLabs API

---

🚀 Getting Started

Prerequisites

To run this project locally, you will need:

• Node.js 18 or higher
• A MongoDB Atlas database
• API keys for Hugging Face and ElevenLabs

Installation

1. Clone the repository:

   git clone https://github.com/your-username/edustory.git
   cd edustory

2. Install dependencies:

   npm install

3. Configure Environment Variables: Create a .env.local file in the root directory:

   HUGGING_FACE_API_KEY=your_key
   ELEVENLABS_API_KEY=your_key
   MONGODB_URI=your_mongodb_uri
   NEXTAUTH_SECRET=your_secret
   NEXTAUTH_URL=http://localhost:3000

4. Start the development server:

   npm run dev

Design Philosophy

The application utilizes a Claymorphism aesthetic. This approach emphasizes tactile elements through the use of soft rounded corners, high-depth shadows, and inner glows. The goal is to create a digital environment that feels responsive and physically grounded.

---

Developed by Raj koli.