https://github.com/dahliaos/pangolin_desktop

Pangolin Desktop UI shell, designed for dahliaOS, written in Flutter.
https://github.com/dahliaos/pangolin_desktop

cross-platform dahliaos dart dart-lang desktop-environment flutter flutter-ui fuchsia fuchsia-os hacktoberfest linux linux-desktop material-design pangolin-desktop ui user-interface

Last synced: about 4 hours ago
JSON representation

Pangolin Desktop UI shell, designed for dahliaOS, written in Flutter.

• Host: GitHub
• URL: https://github.com/dahliaos/pangolin_desktop
• Owner: dahliaOS
• License: apache-2.0
• Created: 2019-03-03T00:34:01.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2024-03-28T16:01:08.000Z (6 months ago)
• Last Synced: 2024-04-14T04:19:00.544Z (5 months ago)
• Topics: cross-platform, dahliaos, dart, dart-lang, desktop-environment, flutter, flutter-ui, fuchsia, fuchsia-os, hacktoberfest, linux, linux-desktop, material-design, pangolin-desktop, ui, user-interface
• Language: Dart
• Homepage: https://web.dahliaos.io
• Size: 295 MB
• Stars: 1,864
• Watchers: 39
• Forks: 184
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        


  

  



 



Website •

Discord •

Releases •

Donate •

Documentation

# Pangolin Desktop

[![Build and Deploy to Web](https://github.com/dahliaOS/pangolin_desktop/actions/workflows/web.yml/badge.svg)](https://github.com/dahliaOS/pangolin_desktop/actions/workflows/web.yml)

[![Locale generator](https://github.com/dahliaOS/pangolin_desktop/actions/workflows/locale_gen.yml/badge.svg)](https://github.com/dahliaOS/pangolin_desktop/actions/workflows/locale_gen.yml)

[![Demo](https://img.shields.io/website?label=Web%20Build&url=https%3A%2F%2Fweb.dahliaos.io&style=for-the-badge)](https://web.dahliaos.io)

[![Crowdin](https://badges.crowdin.net/e/1a53a75fb38f15843d4eb6d9b9e4215a/localized.svg?style=for-the-badge)](https://translate.dahliaos.io/pangolin)

 - 🖥 **Pangolin** is the desktop shell of dahliaOS.

 - 💙 **Written** in Dart/Flutter.

 - 🏝 **[Utopia](https://github.com/dahliaOS/utopia)** is the window manager of Pangolin.

 - 🐚 **Pangolin** was named after a shelled animal like the [Armadillo UI](https://9to5google.com/2018/12/26/fuchsia-armadillo-ui-gone/).

 - 🌐 **Check** the web preview [here](https://web.dahliaos.io).



  

> Settings and start menu, commit [876180d](https://github.com/dahliaOS/pangolin_desktop/commit/876180df15d3b6c8720fb7474d1bcf1b5202fc67).



  

> Calculator, Terminal, Notes and search, commit [876180d](https://github.com/dahliaOS/pangolin_desktop/commit/876180df15d3b6c8720fb7474d1bcf1b5202fc67).

## Development

To develop and locally test Pangolin:

### Step 1. Install development tools

1. Install [Flutter](https://docs.flutter.dev/get-started/install)

2. Install an IDE of your choice (we recommend [VSCode](https://code.visualstudio.com/))

    * 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](/CONTRIBUTING.md)

## Translate

If you're interested in translating Pangolin, click [here](https://github.com/dahliaOS/pangolin_desktop/blob/main/CONTRIBUTING.md#translations) for more information on how to do so!

## License



  

  



Copyright @ 2019-2023 - The dahliaOS Authors - [email protected]

This project is licensed under the [Apache 2.0 license](/LICENSE)