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


Navigation

    Cloudron Forum

    • Register
    • Login
    • Search
    • Categories
    • Recent
    • Tags
    • Popular

    'Shell' App for Jamstack Apps

    App Packaging & Development
    8
    26
    124
    Loading More Posts
    • 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.
    • T
      thetomester13 App Dev @jimcavoli last edited by

      @jimcavoli some good thoughts and resources there, thanks!

      I agree that with my original proposal, I'm not sure if I'm overcomplicating or overengineering a solution to a problem which might not even exist. The main issue I'm seeing with the Github Actions is that the repos I'm talking about (and the ones I envision being used for such a shell app) wouldn't necessarily be owned by the user, so one couldn't add any Actions to that repo. Unless it was a fork of course, but which then still begs the question of auto-updating from upstream.

      I do like the thought of leveraging a solution similar to the Github Pages app as it does do something similar, just limited in the way of building the app (i.e. Jekyll only).

      1 Reply Last reply Reply Quote 0
      • girish
        girish Staff @thetomester13 last edited by

        @thetomester13 said in 'Shell' App for Jamstack Apps:

        with additional benefits such as automatically building the project from source/Github and serving it up

        If you are looking for some inspiration, docs.cloudron.io is just a surfer app. We simply push to the git repo on gitlab and it will automatically deploy with GitLab's CI feature. We use this ci yml.

        T 1 Reply Last reply Reply Quote 2
        • T
          thetomester13 App Dev @girish last edited by

          @girish Nifty!

          jdaviescoates 1 Reply Last reply Reply Quote 1
          • jdaviescoates
            jdaviescoates @thetomester13 last edited by

            I'd really like to be able to do a gitbook style documentation site where users can click edit and then get taken to a git repository where they can edit the page and then submit a pull request.

            What's the best/ easiest way to achieve this on Cloudron? Is it possible? (I'm guessing/ hoping yes).

            marcusquinn girish 2 Replies Last reply Reply Quote 0
            • marcusquinn
              marcusquinn @jdaviescoates last edited by

              @jdaviescoates Maybe MkDocs?

              jdaviescoates 1 Reply Last reply Reply Quote 0
              • jdaviescoates
                jdaviescoates @marcusquinn last edited by

                @marcusquinn yeah, I actually started playing with that locally a while ago but then didn't carry on...

                It would certainly work for nicely displayed documentation using markdown, but I'm not sure I've seen an instance where I can click edit and suggest changes via a PR - have you?

                marcusquinn 1 Reply Last reply Reply Quote 0
                • marcusquinn
                  marcusquinn @jdaviescoates last edited by

                  @jdaviescoates Nope, but I guess you could put the link to the source in the articles. I know what you mean though.

                  jdaviescoates 1 Reply Last reply Reply Quote 0
                  • jdaviescoates
                    jdaviescoates @marcusquinn last edited by

                    @marcusquinn just found this https://docs.v1engineering.com/mkdocs_info/ which looks like an example of what I'm looking for, so must be doable.

                    The question now is could I use some nice a lightweight like Gitea instead of Github or Gitlab...

                    marcusquinn 1 Reply Last reply Reply Quote 1
                    • marcusquinn
                      marcusquinn @jdaviescoates last edited by

                      @jdaviescoates I like GitLab a lot but we use for the full CI/CD stuff. I'm keen to try Gitea & Drone at some point though.

                      jdaviescoates atrilahiji 2 Replies Last reply Reply Quote 0
                      • jdaviescoates
                        jdaviescoates @marcusquinn last edited by

                        @marcusquinn yeah GitLab is great, I just don't actually need it yet and it's quite resource intensive - so would be a bit bonkers to install it just to serve static documentation files!

                        That example I found was using Material and it seems if using GitHub, GitLab or Bitbucket the edit button is automagic:

                        https://squidfunk.github.io/mkdocs-material/setup/adding-a-git-repository/#edit-button

                        So I guess should be possible to use Gitea by editing the edit path setting..

                        marcusquinn 1 Reply Last reply Reply Quote 0
                        • marcusquinn
                          marcusquinn @jdaviescoates last edited by

                          @jdaviescoates Yeah, honestly GitLab is a beast. I'd start with Gitea from what I can see, much lighter and I'm sure would do all you'd need. Easy enough to switch later but I just have so much in GitLab.com I never get round to much else.

                          1 Reply Last reply Reply Quote 1
                          • girish
                            girish Staff @jdaviescoates last edited by

                            @jdaviescoates said in 'Shell' App for Jamstack Apps:

                            What's the best/ easiest way to achieve this on Cloudron? Is it possible? (I'm guessing/ hoping yes).

                            I think bookstack and wikijs is the closest.

                            jdaviescoates 1 Reply Last reply Reply Quote 0
                            • atrilahiji
                              atrilahiji App Dev @marcusquinn last edited by atrilahiji

                              @marcusquinn The workflow for Gitea + Drone on cloudron is quite nice actually with felix's package. Personally I'm still for GitLab for its really good devops and project manaement features. And that it actually looks half decent when accessing it on mobile lol

                              If you guys want I can make a guide for Gridsome (or any other SSG platform) + Gitlab/Gitea + CI + Surfer. Its really quite simple once you get the hang of it.

                              robi 1 Reply Last reply Reply Quote 4
                              • robi
                                robi @atrilahiji last edited by

                                @atrilahiji please do

                                1 Reply Last reply Reply Quote 2
                                • jdaviescoates
                                  jdaviescoates @girish last edited by

                                  @girish said in 'Shell' App for Jamstack Apps:

                                  I think bookstack and wikijs is the closest.

                                  Thanks, I've played with both of those and didn't like either of them.

                                  mkdocs seems to be the way forward...

                                  1 Reply Last reply Reply Quote 0
                                  • atrilahiji
                                    atrilahiji App Dev last edited by

                                    I put together a rather rough/rambly video about JAMstack on cloudron using Gridsome + GitLab CI + Surfer: https://video.lahijiapps.dev/videos/watch/3540b0bb-553f-43bb-8087-fa8e26fd0d46

                                    Let me know if there are questions. Yes I know I look around a lot when I'm nervous and I ramble 😄

                                    nebulon marcusquinn T 3 Replies Last reply Reply Quote 3
                                    • nebulon
                                      nebulon Staff @atrilahiji last edited by

                                      @atrilahiji This is great, can we maybe add this to our peertube instance somehow as well? Not actually sure how we can "link" this, but would be nice if it can also be discovered through our instance

                                      atrilahiji 1 Reply Last reply Reply Quote 1
                                      • atrilahiji
                                        atrilahiji App Dev @nebulon last edited by atrilahiji

                                        @nebulon For sure! I can send DM you with a link to download it. Gotta throw the video up on my nextcloud first. If theres a way to do this via federated access we can try that but I haven't dabbled with that in Peertube yet.

                                        nebulon 1 Reply Last reply Reply Quote 2
                                        • nebulon
                                          nebulon Staff @atrilahiji last edited by

                                          @atrilahiji actually I made our instance follow yours and you either manually or automatically approved that already, now your video is also listed at https://videos.cloudron.io/videos/trending 😉

                                          I also enabled redundancy between your instance and ours, no clue what that means yet, but sounds great!

                                          atrilahiji 1 Reply Last reply Reply Quote 6
                                          • atrilahiji
                                            atrilahiji App Dev @nebulon last edited by

                                            @nebulon Oh cool, thanks! I am definitely open to making more guide for things if needed. I definitely need to be more concise though.

                                            1 Reply Last reply Reply Quote 1
                                            • First post
                                              Last post