soft-path

Soft Paths

A relaxing puzzle game where you connect colorful dots to light up Lumo the lantern. Draw paths between matching colored nodes without crossing other paths to complete each level.

Features

• Connect matching colored dots by drawing paths
• Progressive difficulty across 6 chapters (Tutorial, Basics, Challenge, Advanced, Expert, Master)
• 20 levels per chapter (120 total levels)
• Timer mode for advanced chapters (can be toggled in settings)
• Energy and move limits add strategic depth
• Obstacles in later chapters increase the challenge
• Track your progress with a star rating system (1-3 stars per level)
• Background music and sound effects (can be toggled in settings)
• Lumo the lantern mascot lights up as you complete connections

Game Mechanics

• Drag from one colored dot to its matching pair
• Paths cannot cross each other
• Complete all connections to finish the level
• Earn stars based on efficiency (moves and energy used)
• If you release without completing a connection, the path resets but the move counts

Chapters

1. Tutorial (5x5 grid) - Learn the basics
2. Basics (6x6 grid) - Master the fundamentals
3. Challenge (7x7 grid) - Obstacles appear
4. Advanced (8x8 grid) - Larger grids with timer
5. Expert (9x9 grid) - For seasoned players with timer
6. Master (9x9 grid) - The ultimate challenge with timer

Tech Stack

• Flutter 3.10+
• Flame Game Engine
• audioplayers for sound
• shared_preferences for local storage

Getting Started

Prerequisites

• Flutter SDK 3.10.4 or higher
• Android Studio or VS Code with Flutter extensions

Installation

1. Clone the repository
2. Run flutter pub get to install dependencies
3. Run flutter run to start the app in debug mode

Building for Release

# Build APK
flutter build apk --release

# Build App Bundle (for Play Store)
flutter build appbundle --release

Project Structure

lib/
  app.dart              - Main app widget and navigation
  main.dart             - Entry point
  core/
    constants/          - Game constants, colors
    utils/              - Grid utilities
  data/
    models/             - Data models (Level, Node, Chapter, etc.)
    repositories/       - Progress repository
    services/           - Audio and local storage services
  game/
    circuit_game.dart   - Main Flame game class
    components/         - Game components (nodes, paths, obstacles)
    logic/              - Puzzle generator, path validator, energy calculator
  screens/              - UI screens (menu, game, settings, etc.)

Version

1.0.0

License

This project is proprietary software. All rights reserved.