Skip to content

JappeOS/jappeos_desktop

Repository files navigation


jappeos_desktop

The desktop environment for JappeOS.


Overview

The desktop environment for JappeOS. Written in Flutter.

Features

  • Window manager via jappeos_desktop_base and JDWM
  • Quick settings (Wi-Fi, Bluetooth, Do-not-disturb, etc.)
  • Application launcher
  • System search
  • Virtual desktops
  • Notification menu
  • Topbar & dock

Role in the OS

The main UI that the users interact with after login.

Building

Prerequisites

  • Flutter SDK 3.38.0 or later (with desktop support enabled)
  • Dart SDK (included with Flutter)

Verify Flutter desktop setup:

$ flutter doctor

Setup

Clone the repository and fetch dependencies:

$ git clone https://github.com/JappeOS/jappeos_desktop.git $ cd jappeos_desktop $ flutter pub get

Build

Linux

$ flutter build linux

This produces a binary in:

build/linux/x64/release/bundle/ 

Run locally:

$ flutter run -d linux

Other platforms

While running on Linux is recommended, you can still build and run on other platforms. Just use the above instructions, and replace linux with the platform name (e.g. windows or macos).

Build Modes

  • debug - default for development
  • profile - performance testing
  • release - production build

Example:

$ flutter build linux --release

Troubleshooting

If the build fails after dependency changes:

$ flutter clean $ flutter pub get

Check flutter doctor for missing desktop dependencies.

Contributing

Contributions of all kinds are welcome and appreciated. You can help the project by:

  • ⭐ Starring the repository to show your support
  • 💖 Sponsoring the project (if available)
  • 🐞 Reporting bugs via GitHub Issues
  • 💡 Requesting or discussing new features

For code contributions, please see CONTRIBUTING.md for guidelines.

License

This repository is part of the JappeOS project and is licensed under the terms described in the LICENSE file.

Releases

No releases published

Packages

No packages published