Skip to content

skylarsprogramming/cindie

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

2 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Cindie - Modern Language Learning Platform

A bold, edgy, and modern language learning website built with Next.js, React, and Tailwind CSS. Learn English and German through interactive courses, games, and AI-powered pronunciation practice.

โœจ Features

๐ŸŽฏ Interactive Courses

  • Left Side: Lesson content with vocabulary, grammar explanations, and short stories
  • Right Side: Interactive multiple-choice questions based on the lesson
  • Vocabulary Highlighting: New words with playful animations and "Mark as Learned" feature
  • Progress Tracking: Track completion and mastery levels

๐ŸŽฎ Language Games

  1. Vocabulary Matching: Match English words with German translations
  2. Grammar Builder: Complete sentences with correct grammar
  3. Speed Quiz: Answer questions as fast as possible in 60 seconds

๐ŸŽค Pronunciation Practice

  • Microphone Input: Record yourself speaking
  • Speech Recognition: Real-time transcription using Web Speech API
  • Instant Feedback: Score and improvement suggestions
  • Progress History: Track your pronunciation journey

๐Ÿ“Š Study Dashboard

  • Progress Analytics: Visual progress bars and charts
  • Achievement System: Unlock badges and rewards
  • Learning Streaks: Track daily study consistency
  • Performance Metrics: Detailed statistics and insights

๐Ÿš€ Tech Stack

  • Frontend: Next.js 14, React 18, TypeScript
  • Styling: Tailwind CSS with custom animations
  • Animations: Framer Motion for smooth transitions
  • Icons: Lucide React for consistent iconography
  • Speech Recognition: Web Speech API for pronunciation analysis
  • Responsive Design: Mobile-first approach with full responsiveness

๐ŸŽจ Design Features

  • Bold & Edgy: Black backgrounds with neon/gradient accents
  • Modern UI: Large buttons with hover animations and click effects
  • Smooth Transitions: Framer Motion animations throughout
  • Neon Glow Effects: Eye-catching visual elements
  • Responsive Layout: Works perfectly on desktop, tablet, and mobile

๐Ÿ“ Project Structure

src/
โ”œโ”€โ”€ app/                    # Next.js app directory
โ”‚   โ”œโ”€โ”€ courses/           # Interactive course lessons
โ”‚   โ”œโ”€โ”€ games/             # Language learning games
โ”‚   โ”œโ”€โ”€ pronunciation/     # Pronunciation practice
โ”‚   โ”œโ”€โ”€ dashboard/         # Progress tracking dashboard
โ”‚   โ”œโ”€โ”€ globals.css        # Global styles and Tailwind
โ”‚   โ”œโ”€โ”€ layout.tsx         # Root layout component
โ”‚   โ””โ”€โ”€ page.tsx           # Home page
โ”œโ”€โ”€ components/            # Reusable components
โ”‚   โ””โ”€โ”€ Navigation.tsx     # Main navigation bar
โ””โ”€โ”€ hooks/                 # Custom React hooks

๐Ÿ› ๏ธ Installation & Setup

Prerequisites

  • Node.js 18+
  • npm or yarn

1. Clone the repository

git clone <repository-url>
cd cindie-language-app

2. Install dependencies

npm install

3. Run the development server

npm run dev

4. Open your browser

Navigate to http://localhost:3000

๐ŸŽฏ Available Scripts

  • npm run dev - Start development server
  • npm run build - Build for production
  • npm run start - Start production server
  • npm run lint - Run ESLint

๐ŸŒŸ Key Features Implementation

Course Layout

The courses page implements the exact layout specified:

  • Left Side: Lesson content with vocabulary highlighting
  • Right Side: Interactive quiz questions
  • Vocabulary Management: Click to mark words as learned
  • Progress Tracking: Quiz results and scoring

Interactive Games

Three fully functional language games:

  • Vocabulary Matching: Memory card game with scoring
  • Grammar Builder: Sentence completion with feedback
  • Speed Quiz: Timed question answering

Pronunciation Practice

  • Real-time Recording: Uses MediaRecorder API
  • Speech Recognition: Web Speech API integration
  • Instant Analysis: Score calculation and feedback
  • Progress History: Track improvement over time

Dashboard Analytics

  • Visual Progress: Progress bars for each language level
  • Activity Charts: Weekly learning activity visualization
  • Achievement System: Unlockable badges and points
  • Statistics Overview: Comprehensive learning metrics

๐ŸŽจ Customization

Colors & Themes

The app uses a custom color palette defined in tailwind.config.js:

  • Neon Colors: Pink, blue, green, purple
  • Dark Theme: Multiple shades of dark backgrounds
  • Gradients: Beautiful color transitions throughout

Animations

  • Framer Motion: Smooth page transitions and micro-interactions
  • Custom CSS: Tailwind animations with custom keyframes
  • Hover Effects: Interactive button and card animations

๐Ÿ“ฑ Responsive Design

  • Mobile First: Optimized for mobile devices
  • Tablet Support: Responsive grid layouts
  • Desktop Experience: Full-featured desktop interface
  • Touch Friendly: Optimized for touch interactions

๐Ÿ”ง Browser Support

  • Modern Browsers: Chrome, Firefox, Safari, Edge
  • Speech Recognition: Requires HTTPS for microphone access
  • Progressive Enhancement: Graceful fallbacks for older browsers

๐Ÿš€ Deployment

Vercel (Recommended)

npm run build
vercel --prod

Other Platforms

npm run build
npm run start

๐Ÿค Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests if applicable
  5. Submit a pull request

๐Ÿ“„ License

This project is licensed under the MIT License.

๐Ÿ™ Acknowledgments

  • Next.js Team for the amazing framework
  • Tailwind CSS for the utility-first CSS framework
  • Framer Motion for smooth animations
  • Lucide for beautiful icons

๐Ÿ“ž Support

For questions or support, please open an issue in the repository.


Happy Learning! ๐ŸŽ“โœจ

About

english and german learning website

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published