Zeba Academy Skill Assessment

Flutter Dart License Version

A powerful Flutter package for building skill assessment systems with tests, scoring, weak area detection, and personalized learning recommendations.

✨ Features

🚀 Skill Tests

Create customizable assessments
Multiple choice questions
Skill-based question grouping
Easy integration with Flutter apps

📊 Score Reports

Automatic score calculation
Percentage-based performance reports
Detailed assessment results

🎯 Weak Area Detection

Detect topics where users struggle
Analyze incorrect answers
Identify improvement areas

💡 Recommendations

Generate personalized learning suggestions
Provide skill-focused improvement paths
Help users improve faster

Installation

Add this package to your pubspec.yaml:

dependencies:
  zeba_academy_skill_assessment: ^1.0.0

Run:

flutter pub get

Usage

Import the package:

import 'package:zeba_academy_skill_assessment/zeba_academy_skill_assessment.dart';

Create Questions

final questions = [

  QuestionModel(

    id: "flutter_1",

    question:
    "Which widget does not have mutable state?",

    options: [

      "StatefulWidget",

      "StatelessWidget"

    ],

    correctAnswer: 1,

    skill: "Flutter Basics",

  ),

];

Create Assessment

final assessment = AssessmentModel(

  title: "Flutter Skill Test",

  questions: questions,

);

Open Assessment Screen

Navigator.push(

 context,

 MaterialPageRoute(

  builder: (_) => AssessmentScreen(

    assessment: assessment,

  ),

 ),

);

Assessment Result

The package automatically provides:

Score
Percentage
Weak topics
Recommendations

Example:

result.score

result.percentage

result.weakAreas

result.recommendations

Architecture

lib/

├── models/

│   ├── question_model.dart

│   ├── assessment_model.dart

│   └── result_model.dart


├── engine/

│   └── assessment_engine.dart


├── services/

│   └── recommendation_service.dart


├── widgets/

│   ├── question_card.dart

│   ├── score_report.dart

│   └── recommendation_card.dart


└── screens/

    ├── assessment_screen.dart

    └── result_screen.dart

API Overview

QuestionModel

QuestionModel({

required String id,

required String question,

required List<String> options,

required int correctAnswer,

required String skill,

});

AssessmentEngine

Evaluates user performance.

AssessmentEngine().evaluate(
 
 questions: questions,

 answers: answers,

);

Returns:

ResultModel

ResultModel

Contains:

score

total

percentage

weakAreas

recommendations

Testing

Run package tests:

flutter test

Analyze code:

flutter analyze

Roadmap

Future improvements:

JSON question import
Firebase integration
Online assessment support
Difficulty levels
Timed examinations
Progress tracking
Certificates
Analytics dashboard

About Me

✨ I’m Sufyan bin Uzayr, an open-source developer passionate about building and sharing meaningful projects.

Learn more about my work:

🌐 Website: https://sufyanism.com/

💼 LinkedIn: https://www.linkedin.com/in/sufyanism

Zeba Academy

Your all-in-one learning hub!

🚀 Explore courses and resources in coding, tech, and development.

Zeba Academy is a learning platform dedicated to coding, technology, and development.

Visit:

➡ Main website:

https://zeba.academy

➡ Hands-on courses and resources:

https://code.zeba.academy

➡ YouTube tutorials:

https://www.youtube.com/@zeba.academy

➡ Instagram:

https://www.instagram.com/zeba.academy/

Contributing

Contributions are welcome!

Steps:

Fork this repository
Create a feature branch

git checkout -b feature/new-feature

Commit changes

git commit -m "Add new feature"

Push changes

git push origin feature/new-feature

Open a Pull Request

License

This project is licensed under the GNU General Public License v3.0.

You are free to:

Use
Modify
Share
Distribute

under the terms of the GPL-3.0 license.

See the LICENSE file for details.

Credits

Developed with ❤️ using Flutter.