Skip to content

YTFL/SimpliMap-K-map-Simplifier

Repository files navigation

SimpliMap

SimpliMap is a Flutter app for creating, visualizing and minimizing Boolean expressions using Karnaugh maps (K-maps). It provides a solver UI, step-by-step minimization, and components to explore K-map grouping and simplified expressions.

Features

  • Create and edit minterms and K-maps.
  • Automatic Boolean expression minimization.
  • Step-by-step breakdown of minimization and groupings.
  • Export or view minimized equation results.

Quick start

Prerequisites

Run locally

  1. Get dependencies:
flutter pub get
  1. Run on an available device (Android, iOS, web, desktop):
flutter run
  1. Build release APK (Android):
flutter build apk --release

Build for web:

flutter build web

Project structure (key files)

Explore the lib/ folder for UI widgets and models: models/, widgets/, logic/, and screens/.

Screenshots

Below are screenshots from the app:

Solver screen

K-map grid view

Implicants grouping

Explanation/summary view

Development notes

  • Follow Flutter best practices: use flutter analyze and flutter format regularly.
  • To run the analyzer:
flutter analyze
  • To format code:
flutter format .

Tests

This repository does not appear to include automated tests. Consider adding unit tests for minimizer.dart and widget tests for the main UI screens.

Contributing

Contributions are welcome. Suggested workflow:

  1. Create a feature branch.
  2. Run flutter analyze and flutter format.
  3. Open a pull request with a clear description of changes.

Please add a license file to clarify reuse terms if you plan to accept outside contributions.

License

This project is licensed under the MIT License.

Contact

For questions or collaboration, open an issue in this repository or add a PR with suggested changes.

About

SimpliMap is a Flutter app for creating, visualizing and minimizing Boolean expressions using Karnaugh maps (K-maps). It provides a solver UI, step-by-step minimization, and components to explore K-map grouping and simplified expressions.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors