jappeos_greeter

The login screen for JappeOS.

---

Overview

The login screen for JappeOS, written in Flutter.

Features

• Initial user creation
• User selection
• User login
• Power management

Role in the OS

Usually the first UI the user sees after booting their system.

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_greeter.git
$ cd jappeos_greeter
$ 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.