Awesome

<img width="80%" src="https://github.com/dahliaOS/brand/blob/master/pangolin/svg/logotypewhitetext.svg#gh-dark-mode-only" /> <img width="80%" src="https://github.com/dahliaOS/brand/blob/master/pangolin/svg/logotypeblacktext.svg#gh-light-mode-only" /> <a href="https://dahliaos.io">Website</a> • <a href="https://dahliaos.io/discord">Discord</a> • <a href="https://dahliaos.io/download">Releases</a> • <a href="https://dahliaos.io/donate">Donate</a> • <a href="https://docs.dahliaos.io">Documentation</a>

Pangolin Desktop

🖥 Pangolin is the desktop shell of dahliaOS.
💙 Written in Dart/Flutter.
🏝 Utopia is the window manager of Pangolin.
🐚 Pangolin was named after a shelled animal like the Armadillo UI.
🌐 Check the web preview here.

<img width="100%" src="https://docs.dahliaos.io/docs/pangolin/settings.webp"

Settings and start menu, commit 876180d.

<img width="100%" src="https://docs.dahliaos.io/docs/pangolin/search.webp"

Calculator, Terminal, Notes and search, commit 876180d.

Development

To develop and locally test Pangolin:

Step 1. Install development tools

Install Flutter
Install an IDE of your choice (we recommend VSCode)
- We also recommend installing Dart and Flutter extensions if you're opting in for VSCode. For other IDEs, please inform yourself.

Step 2. Run Pangolin

Note: You can run Pangolin on any platform that Flutter supports but we recommend running it on Linux as some features of Pangolin are designed exclusively for Linux and won't work on other platforms.

Run Pangolin by running:

make run target=linux

List of targets:

linux
windows
macos

Flutter has hot reloading so no need to restart the instance when it's running!

Contribute

If you're wondering how to contribute to the project, please refer to CONTRIBUTING.md

Translate

If you're interested in translating Pangolin, click here for more information on how to do so!

License

This project is licensed under the Apache 2.0 license