'Shell' App for Jamstack Apps
-
I just realized that I have now have 2 apps (Nomie and CyberChef) on Cloudron deployed through Surfer by building their source code, and simply uploading the production code to Surfer to be served up.
This got me thinking (dangerous!) about potentially creating a 'shell'-like application that could wrap Jamstack apps (apps that only need a front end and don't need a hosted backend/API) with additional benefits such as automatically building the project from source/Github and serving it up, optional minor version updates based on Github releases, specifying the app's icon path within the project, and I'm sure there could be other nifty features like this.
I'm not entirely sure how to go about this yet, and some Terminal tinkering would probably need to be done (i.e. must be a tech-savvy user to set it up), but I'm wondering if other people would be interested in something like this? I don't mind having the apps that I'm currently running in their current state, or even try to automate them using some CLI + Cron, but am willing to give building this out a shot.
(Also wasn't sure if this is the proper topic for this, feel free to move if more appropriate elsewhere!)
@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.
-
@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.
-
@girish Nifty!
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).
-
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).
@jdaviescoates Maybe MkDocs?
Web Design https://www.evergreen.je
Development https://brandlight.org
Life https://marcusquinn.com -
@jdaviescoates Maybe MkDocs?
@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 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?
@jdaviescoates Nope, but I guess you could put the link to the source in the articles. I know what you mean though.
Web Design https://www.evergreen.je
Development https://brandlight.org
Life https://marcusquinn.com -
@jdaviescoates Nope, but I guess you could put the link to the source in the articles. I know what you mean though.
@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 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...
@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.
Web Design https://www.evergreen.je
Development https://brandlight.org
Life https://marcusquinn.com -
@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.
@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 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..
@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.
-
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).
@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 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.
@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.
-
@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.
-
@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.
@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...
-
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
-
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
-
@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
@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 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.
@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 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!
@nebulon Oh cool, thanks! I am definitely open to making more guide for things if needed. I definitely need to be more concise though.
-
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
@atrilahiji Just watched - very cool!
Does peertube allow for making "friends" from one instance to another?
I have mine setup at https://peertube.marcusquinn.com (although only private videos for friends & family at the mo)
