Skip to content

A fun, interactive, and AI-powered science tutor designed specifically for Grade 5 students (ages 10-11).

Notifications You must be signed in to change notification settings

MdBilal420/scifly

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

22 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš€ SciFly - AI-Powered Science Tutor for Grade 5 Students

A fun, interactive, and responsive React frontend for an AI-powered science tutor designed specifically for Grade 5 students (ages 10-11). Built with modern web technologies and following UX best practices for young learners.

โœจ Features

๐ŸŽ“ Educational Content

  • Interactive Lessons: Engaging science lessons with tap-to-reveal mechanics
  • Smart Quizzes: Adaptive quizzes with instant feedback and explanations
  • AI Chat: Natural conversation with Nova the Owl for science questions
  • Achievement System: Gamified learning with badges and progress tracking

๐ŸŽจ Kid-Friendly UX

  • Nova the Owl: Friendly AI mascot with animations and personality
  • Bright Colors: Playful gradient backgrounds and vibrant UI elements
  • Large Touch Targets: Optimized for young fingers on tablets and phones
  • Immediate Feedback: Visual and audio confirmation for all actions
  • Error-Tolerant Design: Forgiving interface that encourages exploration

๐Ÿ“ฑ Responsive Design

  • Mobile-First: Optimized for tablets and smartphones
  • Touch-Friendly: Large buttons and intuitive gestures
  • Smooth Animations: Framer Motion animations that delight and guide
  • Accessible: High contrast and readable fonts

๐Ÿ› ๏ธ Tech Stack

  • React 18 with TypeScript for type safety
  • Redux Toolkit for state management
  • Tailwind CSS for styling and responsive design
  • Framer Motion for smooth animations and transitions
  • Modern Build Tools with Create React App

๐Ÿš€ Getting Started

Prerequisites

  • Node.js 16+ and npm/yarn
  • Modern web browser

Installation

  1. Clone and setup:

    git clone <your-repo>
    cd scifly
    npm install
  2. Start development server:

    npm start
  3. Open your browser: Navigate to http://localhost:3000

Available Scripts

  • npm start - Start development server
  • npm build - Build for production
  • npm test - Run tests
  • npm run eject - Eject from Create React App

๐Ÿ“ Project Structure

src/
โ”œโ”€โ”€ components/          # Reusable UI components
โ”‚   โ”œโ”€โ”€ AvatarIcon.tsx
โ”‚   โ”œโ”€โ”€ NovaMascot.tsx
โ”‚   โ”œโ”€โ”€ PrimaryButton.tsx
โ”‚   โ”œโ”€โ”€ QuizCard.tsx
โ”‚   โ”œโ”€โ”€ AchievementBadge.tsx
โ”‚   โ””โ”€โ”€ ProgressBar.tsx
โ”œโ”€โ”€ features/            # Redux slices
โ”‚   โ”œโ”€โ”€ progress/
โ”‚   โ”œโ”€โ”€ quiz/
โ”‚   โ”œโ”€โ”€ chat/
โ”‚   โ””โ”€โ”€ achievements/
โ”œโ”€โ”€ pages/               # Main application screens
โ”‚   โ”œโ”€โ”€ HomeScreen.tsx
โ”‚   โ”œโ”€โ”€ LessonScreen.tsx
โ”‚   โ”œโ”€โ”€ QuizScreen.tsx
โ”‚   โ”œโ”€โ”€ ChatScreen.tsx
โ”‚   โ””โ”€โ”€ AchievementsScreen.tsx
โ”œโ”€โ”€ App.tsx             # Main app component
โ”œโ”€โ”€ store.ts            # Redux store configuration
โ””โ”€โ”€ index.tsx           # App entry point

๐ŸŽฎ How to Use

For Students

  1. Start Learning: Tap "Learn About Gravity" to begin your first lesson
  2. Interactive Discovery: Tap elements to reveal science facts
  3. Test Knowledge: Take quizzes to check your understanding
  4. Ask Questions: Chat with Nova about anything science-related
  5. Earn Achievements: Complete lessons and unlock cool badges

For Educators/Parents

  • Monitor progress through the achievement system
  • Review lesson completion and quiz scores
  • Encourage daily learning streaks
  • Use the chat feature to spark science curiosity

๐ŸŽจ Design Principles

Child-Centered UX

  • Visual Hierarchy: One primary action per screen
  • Immediate Feedback: Every interaction provides clear response
  • Progressive Disclosure: Information revealed step-by-step
  • Mistake-Friendly: Errors treated as learning opportunities

Engagement Strategies

  • Mascot Guidance: Nova provides context-aware tips and encouragement
  • Gamification: Points, streaks, and badges motivate learning
  • Personalization: Progress tracking and adaptive content
  • Social Features: Safe sharing of achievements

๐Ÿ”ง Customization

Adding New Lessons

  1. Update lessonContent in LessonScreen.tsx
  2. Add corresponding quiz questions in quizSlice.ts
  3. Create achievement triggers in lesson completion logic

Styling Modifications

  • Edit Tailwind classes in components
  • Modify color scheme in tailwind.config.js
  • Adjust animations in Framer Motion components

AI Integration

  • Replace mock responses in chatSlice.ts with real AI API calls
  • Add environment variables for API configuration
  • Implement proper error handling for network requests

๐ŸŽฏ Learning Goals

Science Concepts (Grade 5 Level)

  • Gravity: Understanding forces and their effects
  • Solar System: Planets, moon phases, and space
  • Water Cycle: Evaporation, condensation, precipitation
  • Plant Growth: Photosynthesis and life cycles

21st Century Skills

  • Digital Literacy: Comfortable with technology interfaces
  • Critical Thinking: Questioning and hypothesis formation
  • Communication: Expressing ideas through chat interactions
  • Self-Directed Learning: Progress tracking and goal setting

๐ŸŒŸ Future Enhancements

Educational Features

  • More science topics (biology, chemistry, physics)
  • Virtual lab experiments with simulations
  • Peer collaboration features (safe classroom mode)
  • Parent/teacher dashboard for progress monitoring

Technical Improvements

  • Voice recognition for chat interactions
  • Offline mode for lesson content
  • Multi-language support
  • Advanced accessibility features

AI Capabilities

  • Personalized learning paths
  • Adaptive difficulty based on performance
  • Natural language question generation
  • Real-time concept understanding assessment

๐Ÿค Contributing

We welcome contributions! Please read our contributing guidelines and submit pull requests for any improvements.

๐Ÿ“„ License

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

๐Ÿ™ Acknowledgments

  • Designed with insights from elementary education experts
  • Icons and animations inspired by child-friendly design patterns
  • Built with accessibility guidelines from W3C WCAG
  • Tested with real Grade 5 students and teachers

Made with โค๏ธ for curious young scientists! ๐Ÿ”ฌ๐ŸŒŸ

About

A fun, interactive, and AI-powered science tutor designed specifically for Grade 5 students (ages 10-11).

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published