Publish anything, just by saving a file

The Hub serves folders straight from our LucidLink volumes. Edit a folder on your mount and it’s live on the tiger-team hub in about two seconds — no deploy, no commit, no publish button.

Before you start

You need a LucidLink volume mounted on your machine — engineering, tiger-team, or whichever your team uses — plus an invite to it. If /Volumes/<your-volume> isn’t there yet, ask your IT team for access. That’s the only prerequisite.

Publish a folder

Drop a file named .hub.yml into any top-level folder on your volume. An empty one is enough — the folder shows up on the hub at /<folder>, under its volume’s section on the home page. Add a few fields to shape it:

# /Volumes/tiger-team/q3-review/.hub.yml
title:  Q3 Review
icon:   fa-chart-column    # any Font Awesome icon name
entry:  index.html         # the file that opens (default: index.html)

• Static already? Just an index.html plus an empty .hub.yml — done.
• Title and icon (any Font Awesome name, e.g. fa-book) set how the card looks. Leave them off and it uses the folder name and a default icon.
• Entry points at the file to open if it isn’t index.html.

Keep it private

Add a users: list and the app is restricted to exactly those people. Everyone else won’t see it on the home page and can’t open it even with the direct link. A small lock appears on the card so you know it’s limited.

users:
  - you@lucidlink.com
  - teammate@lucidlink.com

That’s the whole model

Save the file and it’s live — the home page picks it up on its own, no refresh needed. To change or remove it, just edit or delete the folder on your mount. There’s nothing to deploy and nothing to commit; GitHub, where it exists, is only a backup.