Publish an Astro Starlight website hosted on Gogs using Cubby on Cloudron
-
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 developmentThe 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.
-
-
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 -
Out of interest, why using Cubby not Surfer, if this is essentially hosting/publishing docs ?
-
Out of interest, why using Cubby not Surfer, if this is essentially hosting/publishing docs ?
@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...
-
J james marked this topic as a regular topic
-
@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...
@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.