Cloudron makes it easy to run web apps like WordPress, Nextcloud, GitLab on your server. Find out more or install now.


Skip to content
  • Categories
  • Recent
  • Tags
  • Popular
  • Bookmarks
  • Search
Skins
  • Light
  • Cerulean
  • Cosmo
  • Flatly
  • Journal
  • Litera
  • Lumen
  • Lux
  • Materia
  • Minty
  • Morph
  • Pulse
  • Sandstone
  • Simplex
  • Sketchy
  • Spacelab
  • United
  • Yeti
  • Zephyr
  • Dark
  • Cyborg
  • Darkly
  • Quartz
  • Slate
  • Solar
  • Superhero
  • Vapor

  • Default (No Skin)
  • No Skin
Collapse
Brand Logo

Cloudron Forum

Apps | Demo | Docs | Install
  1. Cloudron Forum
  2. Discuss
  3. Potential Cloudron Theme/Dashboard

Potential Cloudron Theme/Dashboard

Scheduled Pinned Locked Moved Discuss
dashboardcustom-appsapi
34 Posts 10 Posters 4.9k Views 12 Watching
  • Oldest to Newest
  • Newest to Oldest
  • Most Votes
Reply
  • Reply as topic
Log in to reply
This topic has been deleted. Only users with topic management privileges can see it.
  • nebulonN Offline
    nebulonN Offline
    nebulon
    Staff
    wrote on last edited by
    #8

    I very much like the idea for such a dashboard being installed as an app instead of trying to make the main/admin dashboard overly configurable or theme-able.

    For app listing, we could add a new app addon type which gets a restricted access token to fetch app listings and meta information. However we have to see how that works with regards to the access controls. For future auditing reasons, it may be better to not add some whitelisting mechanism which circumvents token validation. I wonder if the mentioned APIs would be sufficient for a good dashboard?

    1 Reply Last reply
    2
    • girishG Offline
      girishG Offline
      girish
      Staff
      wrote on last edited by
      #9

      We can implement read-only tokens for a start.

      1 Reply Last reply
      2
      • T Offline
        T Offline
        thetomester13
        App Dev
        wrote on last edited by
        #10

        @nebulon

        I very much like the idea for such a dashboard being installed as an app instead of trying to make the main/admin dashboard overly configurable or theme-able.

        Agreed! I like the idea of a new addon type that would give an app 'automatic access' (doesn't have to be configured by end user) to some API endpoints. I agree with @girish that read-only access would work, but even just the 2 endpoints I listed above would be a solid start. I could eventually see endpoints like 'Get Status' or streams from tasks or services being handy for such dashboards.

        1 Reply Last reply
        1
        • T thetomester13

          Hello all!

          I've been developing/packaging what I think could be a new form of Cloudron apps, Themes (working title : ). The idea here is a simple Homepage that will display your installed Cloudron applications for easy access. You can see a working copy on my instance here! Be sure to hit space bar to toggle the menu.

          Features include:

          • Lightning fast loading - 97 Lighthouse Performance rating, all JS/CSS assets are local
          • Toggle menu based on any key combination
          • Background images from Unsplash or custom URL
          • Quick link to Cloudron dashboard
          • Use number keys to go directly to the first 9 apps listed when the menu is open
          • Mobile friendly
          • Caching of app images
          • Security when it comes to your Cloudron API key and Unsplash ID

          Note that this is NOT meant to replace the current Cloudron dashboard, but rather be a supplementary 'app browser'. When the menu is displayed in the Homepage App, there is a cog icon at the top right with the time stamp that will take you straight to your original Cloudron dashboard when you need full access to Backups, Logs, etc.

          This app is based on the homepage-cloudron repo, which is based off of the homepage repo, both of which I am the author of. Happy to answer any questions! You can find the Cloudron packaged app here.

          If this is interesting, I could work up some basic tests for this to eventually be included in the actual Cloudron App Store. Though it is important to note that for this to work properly, the setup requires creating a new Cloudron API key and updating the config.json file through the Terminal (not super user-friendly).

          Thoughts/suggestions/notes welcome!

          BrentHuethB Offline
          BrentHuethB Offline
          BrentHueth
          wrote on last edited by
          #11

          @thetomester13 said in Potential Cloudron Theme/Dashboard:

          homepage-cloudron

          Hey there @thetomester13, is this something I can try out? I understand the rudiments of building and installing custom apps, but not sure if I need to fork your repo, of just cloning it will work. I requested access on gitlab.

          T 1 Reply Last reply
          1
          • BrentHuethB BrentHueth

            @thetomester13 said in Potential Cloudron Theme/Dashboard:

            homepage-cloudron

            Hey there @thetomester13, is this something I can try out? I understand the rudiments of building and installing custom apps, but not sure if I need to fork your repo, of just cloning it will work. I requested access on gitlab.

            T Offline
            T Offline
            thetomester13
            App Dev
            wrote on last edited by
            #12

            @BrentHueth absolutely it's something you can try out! You can simply clone the repo and then do a cloudron build and cloudron install (there are some prerequisites to this, be sure to check the official Cloudron documentation). I gave you developer access to the repo in case you did want to contribute, just know that the git.cloudron repo is the Cloudron packaged app, you can find the actual application on Github here.

            BrentHuethB 1 Reply Last reply
            1
            • T thetomester13

              @BrentHueth absolutely it's something you can try out! You can simply clone the repo and then do a cloudron build and cloudron install (there are some prerequisites to this, be sure to check the official Cloudron documentation). I gave you developer access to the repo in case you did want to contribute, just know that the git.cloudron repo is the Cloudron packaged app, you can find the actual application on Github here.

              BrentHuethB Offline
              BrentHuethB Offline
              BrentHueth
              wrote on last edited by
              #13

              @thetomester13 If I'm not your first thrilled user, well then I'm another 🙂

              https://cln.sh/DboCtu

              1 Reply Last reply
              2
              • murgeroM Offline
                murgeroM Offline
                murgero
                App Dev
                wrote on last edited by
                #14

                Is this project similar to Heimdall? It's what I am currently using as a dashboard (Currently Personal, but it is hosted on my Cloudron and displaying some custom links and apps)

                037009ee-3fbc-4585-afe6-6629821d1037-image.png

                --
                https://urgero.org
                ~ Professional Nerd. Freelance Programmer. ~

                1 Reply Last reply
                5
                • T Offline
                  T Offline
                  thetomester13
                  App Dev
                  wrote on last edited by
                  #15

                  @BrentHueth 🙃 that makes me happy

                  @murgero yes, this is similar to Heimdall, it's based off of this Github project of which I'm the author. This particular app is purposefully packaged for Cloudron in that you give it an API key and it will auto-populate with all of your Cloudron apps, so no custom links at the moment.

                  murgeroM 1 Reply Last reply
                  3
                  • T thetomester13

                    @BrentHueth 🙃 that makes me happy

                    @murgero yes, this is similar to Heimdall, it's based off of this Github project of which I'm the author. This particular app is purposefully packaged for Cloudron in that you give it an API key and it will auto-populate with all of your Cloudron apps, so no custom links at the moment.

                    murgeroM Offline
                    murgeroM Offline
                    murgero
                    App Dev
                    wrote on last edited by
                    #16

                    @thetomester13 That's pretty cool!! I'll have to give this a shot then 🙂 Thanks!

                    --
                    https://urgero.org
                    ~ Professional Nerd. Freelance Programmer. ~

                    T 1 Reply Last reply
                    2
                    • murgeroM murgero

                      @thetomester13 That's pretty cool!! I'll have to give this a shot then 🙂 Thanks!

                      T Offline
                      T Offline
                      thetomester13
                      App Dev
                      wrote on last edited by
                      #17

                      @murgero sure! Let me know if you have any notes/suggestions!

                      1 Reply Last reply
                      1
                      • girishG Offline
                        girishG Offline
                        girish
                        Staff
                        wrote on last edited by
                        #18

                        @murgero Do you host heimdall on Cloudron? Is there a package?

                        murgeroM 1 Reply Last reply
                        2
                        • girishG girish

                          @murgero Do you host heimdall on Cloudron? Is there a package?

                          murgeroM Offline
                          murgeroM Offline
                          murgero
                          App Dev
                          wrote on last edited by murgero
                          #19

                          @girish No package, it's a simple PHP script - just used the LAMP app. I'd be happy to package it though if there is enough demand for it. That said I do not want to take over this thread so if anyone wants it - start a new thread.

                          --
                          https://urgero.org
                          ~ Professional Nerd. Freelance Programmer. ~

                          W 1 Reply Last reply
                          2
                          • murgeroM murgero

                            @girish No package, it's a simple PHP script - just used the LAMP app. I'd be happy to package it though if there is enough demand for it. That said I do not want to take over this thread so if anyone wants it - start a new thread.

                            W Offline
                            W Offline
                            will
                            wrote on last edited by
                            #20

                            @murgero This would be dope to be rolled into cloudron if the owner & devs are open to that.

                            1 Reply Last reply
                            1
                            • girishG Offline
                              girishG Offline
                              girish
                              Staff
                              wrote on last edited by
                              #21

                              We probably won't merge it into Cloudron itself but as a stand alone project which is packaged for Cloudron, we have no problems. Happy to publish it in our App Store as well (but it has to be a stand alone project like the rest of the apps we package).

                              T 1 Reply Last reply
                              3
                              • girishG girish

                                We probably won't merge it into Cloudron itself but as a stand alone project which is packaged for Cloudron, we have no problems. Happy to publish it in our App Store as well (but it has to be a stand alone project like the rest of the apps we package).

                                T Offline
                                T Offline
                                thetomester13
                                App Dev
                                wrote on last edited by
                                #22

                                @girish what do you think of implementing the 'read only' token permission for apps like this so they can automatically display a list of installed Cloudron apps without user intervention?

                                robiR 1 Reply Last reply
                                1
                                • T thetomester13

                                  Hello all!

                                  I've been developing/packaging what I think could be a new form of Cloudron apps, Themes (working title : ). The idea here is a simple Homepage that will display your installed Cloudron applications for easy access. You can see a working copy on my instance here! Be sure to hit space bar to toggle the menu.

                                  Features include:

                                  • Lightning fast loading - 97 Lighthouse Performance rating, all JS/CSS assets are local
                                  • Toggle menu based on any key combination
                                  • Background images from Unsplash or custom URL
                                  • Quick link to Cloudron dashboard
                                  • Use number keys to go directly to the first 9 apps listed when the menu is open
                                  • Mobile friendly
                                  • Caching of app images
                                  • Security when it comes to your Cloudron API key and Unsplash ID

                                  Note that this is NOT meant to replace the current Cloudron dashboard, but rather be a supplementary 'app browser'. When the menu is displayed in the Homepage App, there is a cog icon at the top right with the time stamp that will take you straight to your original Cloudron dashboard when you need full access to Backups, Logs, etc.

                                  This app is based on the homepage-cloudron repo, which is based off of the homepage repo, both of which I am the author of. Happy to answer any questions! You can find the Cloudron packaged app here.

                                  If this is interesting, I could work up some basic tests for this to eventually be included in the actual Cloudron App Store. Though it is important to note that for this to work properly, the setup requires creating a new Cloudron API key and updating the config.json file through the Terminal (not super user-friendly).

                                  Thoughts/suggestions/notes welcome!

                                  marcusquinnM Offline
                                  marcusquinnM Offline
                                  marcusquinn
                                  wrote on last edited by
                                  #23

                                  @thetomester13 Very nice work!

                                  Seems like an app to me, perhaps call it "Start Page", similar to: https://start.me

                                  I'd like the links to open in a new window/tab, the ability to adjust icon size, number of columns, and additional non-cloudron links.

                                  I like the Start Page feature in Vivaldi for inspiration: https://help.vivaldi.com/article/speed-dials/

                                  Not a fan of frame scrollbars or hidden features, would prefer just to have it as a URL where they are always shown,, something like startpage.example.com that we can give to users to set as their browser home page with a search bar for a selection of search engines and cloudron itself.

                                  Web Design https://www.evergreen.je
                                  Development https://brandlight.org
                                  Life https://marcusquinn.com

                                  1 Reply Last reply
                                  1
                                  • marcusquinnM Offline
                                    marcusquinnM Offline
                                    marcusquinn
                                    wrote on last edited by
                                    #24

                                    More inspiration:

                                    • https://bonjourr.fr
                                    • https://github.com/victorazevedo-me/Bonjourr

                                    Web Design https://www.evergreen.je
                                    Development https://brandlight.org
                                    Life https://marcusquinn.com

                                    1 Reply Last reply
                                    1
                                    • T thetomester13

                                      @girish what do you think of implementing the 'read only' token permission for apps like this so they can automatically display a list of installed Cloudron apps without user intervention?

                                      robiR Offline
                                      robiR Offline
                                      robi
                                      wrote on last edited by
                                      #25

                                      @thetomester13
                                      I don't think this is required, as users cannot install and manage apps, only admins can. That means that during the App install there can be a user selection for who it's for by an admin which injects their profile/API key into the app and installs it, becoming the default of what a non-admin user sees at their URL. Login only required per App.

                                      Use of Rambox or WebCatalog can do something similar on the desktop, saving the need for crating entries for all the separate apps but just for their 'homepage' / startpage.

                                      Conscious tech

                                      1 Reply Last reply
                                      0
                                      • T Offline
                                        T Offline
                                        thetomester13
                                        App Dev
                                        wrote on last edited by
                                        #26

                                        @marcusquinn thanks! I am trying to keep the project relatively simple so I don't want to get too deep into features. It is worth noting though that the original Homepage app does support opening links in new tabs. I could see a feature on the Cloudron app where it's an all-or-nothing boolean - all links will open in a new tab, or all links will open in the same tab. I also could see supporting non-Cloudron app links, and potentially number of columns. The way I see it, the icons should possibly adjust automatically based on the number of columns (again, this is a bit of the complexity I'm trying to avoid with a KISS app). The search bar I've also purposefully avoided this whole time, but I'm open to suggestions. It's also worth noting that you are free to create PR's into the Github repo if you want to contribute!

                                        @robi that's an interesting point. Only admins are installing new applications indeed, but still, I'm not sure that all admins are capable or comfortable with going to an app's terminal, vim'ing (is that a verb??) the config file and adding in an API key. That being said, it's probably a good enough start for now, and could potentially revisit if/when @girish or @nebulon decide to add such a feature.

                                        1 Reply Last reply
                                        5
                                        • robiR Offline
                                          robiR Offline
                                          robi
                                          wrote on last edited by
                                          #27

                                          Have you seen DashMachine?

                                          Sounds like right up your alley!

                                          Conscious tech

                                          T 1 Reply Last reply
                                          1
                                          Reply
                                          • Reply as topic
                                          Log in to reply
                                          • Oldest to Newest
                                          • Newest to Oldest
                                          • Most Votes


                                          • Login

                                          • Don't have an account? Register

                                          • Login or register to search.
                                          • First post
                                            Last post
                                          0
                                          • Categories
                                          • Recent
                                          • Tags
                                          • Popular
                                          • Bookmarks
                                          • Search