Getting Started

⚙️ System Setup Guide #

How to Run and Customize the Ultimate Desktop App (for UltimatePOS)

💡 If you are not familiar with coding, Ultimate Desktop is already packaged and ready to use.
However, if you’d like to customize the source code or contribute to development, follow this guide to set up your environment.

✅ Supported Platforms: #

• Windows 10/11 (64-bit)

• macOS (64-bit)

• Linux (Ubuntu/Debian-based, 64-bit)

🚀 Supported Flutter Version: #

• Flutter 3.32.4 or above (Channel: stable)

Older versions may not be compatible with the latest features or dependencies of the app.

📦 Required Tools: #

• Flutter SDK (stable channel)

• Android Studio or Visual Studio Code

• Git (optional, for source versioning)

• Java SDK 17 (recommended for Android builds)

🔧 Setup Steps: #

1. Install Flutter

   • Visit: flutter.dev/docs/get-started/install

   • Make sure to follow platform-specific instructions.

   • Run flutter doctor to verify your environment.

2. Install an Editor

   • Recommended: Android Studio or Visual Studio Code.

   • Be sure to install Dart & Flutter extensions/plugins.

3. Set JDK Version (For Android Builds)

   • Use JDK 17 for compatibility with Gradle.

   • On Windows/macOS, set it with:
     flutter config --jdk-dir="<path-to-jdk-17>"

4. Run the App

   • Open the project folder in your editor.

   • Run flutter pub get to install dependencies.

   • Use a simulator or connect a device.

   • Press Run to launch the app.

❗ Note: #

This application runs fully offline with local database support and native system integrations.