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. Cubby
  3. Publish an Astro Starlight website hosted on Gogs using Cubby on Cloudron

Publish an Astro Starlight website hosted on Gogs using Cubby on Cloudron

Scheduled Pinned Locked Moved Cubby
astrostarlightcubbydocumentation
6 Posts 3 Posters 91 Views 3 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.
  • L Offline
    L Offline
    LoudLemur
    wrote last edited by LoudLemur
    #1

    We are using Gogs for our project's Astro / Starlight documentation. (Starlight is the way forward for the future - use islands.)

    How can we use cubby, which is also on our cloudron, to publish the site?

    Which folder should be the public folder? Where should it be? is where it is expected mentioned in the docs?

    Astro:
    https://astro.build/

    Starlight
    https://docs.astro.build/en/getting-started/

    via Claude ai:

    🌟 Astro Starlight: The Future of Documentation

    Why Starlight Dominates the Documentation Landscape

    ⚑ Performance That Actually Matters

    • Zero JS by default - Ships pure HTML/CSS, loads instantly
    • Islands Architecture - Interactive components only where needed
    • Perfect Lighthouse scores out of the box
    • Sub-second page loads even on slow connections

    🎨 Developer Experience Redefined

    • Content Collections - Type-safe frontmatter with automatic validation
    • MDX + Components - Full React/Vue/Svelte component support in markdown
    • Hot reloading that actually works reliably
    • Built-in TypeScript support without configuration hell

    πŸ”§ Modern Tooling Integration

    • Vite-powered - Lightning fast builds and HMR
    • Framework agnostic - Use React, Vue, Svelte, or plain HTML
    • Tailwind CSS integration with zero config
    • Automatic image optimization and lazy loading

    πŸ“± Mobile-First Design

    • Responsive by default - Looks perfect on every device
    • Dark/light mode with system preference detection
    • Accessible navigation with keyboard and screen reader support
    • Progressive Web App capabilities built-in

    πŸš€ Deployment Superpowers

    • Static site generation - Deploy anywhere (Netlify, Vercel, GitHub Pages)
    • Edge-ready - Optimized for CDN distribution
    • Incremental builds - Only rebuild what changed
    • Preview deployments work seamlessly

    πŸ₯Š The Competition Doesn't Stand a Chance

    Feature Starlight Docusaurus MkDocs GitBook
    Build Speed ⚑ Vite-fast 🐌 Webpack slow 🐌 Python slow ☁️ Cloud-dependent
    Bundle Size πŸͺΆ Minimal JS πŸ“¦ React bloat 🐍 Theme dependent 🌐 SaaS overhead
    Customization 🎨 Full control πŸ”’ React-locked 🎭 Theme-limited πŸ’° Paywall-gated
    Type Safety βœ… Built-in TS ❌ Manual setup ❌ None ❌ None
    Modern Stack πŸš€ Cutting edge βš›οΈ React-only 🐍 Python legacy 🏒 Enterprise bloat

    🎯 Killer Features Exclusive to Starlight

    • Automatic sidebar generation from file structure
    • Built-in search with zero configuration
    • Internationalization that doesn't suck
    • API documentation auto-generation from TypeScript
    • Version control without the complexity
    • Custom CSS properties for effortless theming

    πŸŒ… Why Starlight is the Future

    Content-first approach - Write docs, not configuration files
    Performance by design - Fast sites aren't an afterthought
    Developer happiness - Tools that get out of your way
    Future-proof - Built on web standards, not framework trends
    Community-driven - Open source with active development

    πŸ’‘ The Bottom Line

    While Docusaurus forces you into React, MkDocs traps you in Python, and GitBook locks you into SaaS, Starlight gives you the best of all worlds: modern tooling, incredible performance, and the freedom to build exactly what you need.

    Starlight isn't just another documentation tool - it's the evolution of what documentation should be.

    1 Reply Last reply
    2
    • L LoudLemur marked this topic as a question
    • L Offline
      L Offline
      LoudLemur
      wrote last edited by LoudLemur
      #2

      Answer

      From your cloudron panel, open Cubby and go into the folders. You want to be in /app/data/data/yourusername/

      create a folder in there eg docs

      upload your astro starlight dist folder into your newly created (in this case) docs folder.

      The following didn't work - we couldn't change ownership to www-data

      Navigate to your docs folder (where you uploaded the files)
      Look for a β€œShare” button or option - this is usually:
      A share icon (πŸ”— or ↗️)
      Right-click context menu
      Button at the top of the interface
      Settings/options for the folder
      Generate a public/shareable link for the docs folder
      Make sure to share the index.html file specifically or the entire folder
      The URL structure will typically be something like:
      https://your-cubby-domain/shared/[share-id]/index.html
      https://your-cubby-domain/[username]/docs/index.html

      1 Reply Last reply
      0
      • timconsidineT Online
        timconsidineT Online
        timconsidine
        App Dev
        wrote last edited by
        #3

        Out of interest, why using Cubby not Surfer, if this is essentially hosting/publishing docs ?

        L 1 Reply Last reply
        1
        • timconsidineT timconsidine

          Out of interest, why using Cubby not Surfer, if this is essentially hosting/publishing docs ?

          L Offline
          L Offline
          LoudLemur
          wrote last edited by
          #4

          @timconsidine Hey, Tim, thanks for asking. I hadn't used Surfer for so long I completely forgot about it!

          That is an ideal solution. I will have to try it. I wonder if we could try serving our gemini-protocol pages on there, too...

          timconsidineT 1 Reply Last reply
          0
          • jamesJ james marked this topic as a regular topic
          • jamesJ Offline
            jamesJ Offline
            james
            Staff
            wrote last edited by
            #5

            Yes, Surfer would be the correct app for this use-case.

            1 Reply Last reply
            2
            • L LoudLemur

              @timconsidine Hey, Tim, thanks for asking. I hadn't used Surfer for so long I completely forgot about it!

              That is an ideal solution. I will have to try it. I wonder if we could try serving our gemini-protocol pages on there, too...

              timconsidineT Online
              timconsidineT Online
              timconsidine
              App Dev
              wrote last edited by
              #6

              @LoudLemur surfer serves http content, so you can't (as it stands now) serve gemini files from it.

              You need the app from @DidierMalenfant or my agate+ app.

              Just making changes to agate+ app and releasing new version later today. Will try to publish an image for it to simplify testing.

              1 Reply Last reply
              2
              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