Development

Clone the repository

Clone superbonfire-lab/internal-hub. The stack is TanStack Start, Vite, and React.

Start locally

1. Copy .env.example to .env.
2. Run npm install.
3. Run npm run dev.
4. Open http://127.0.0.1:5173/. The last slash is required for Feishu.

Change the catalog

Edit src/data/hub.json.

• sections — groups of links. The hub has applications and docs.
• Each link needs id, name, description, badge, icon, url, and keywords. Icons are Phosphor names.
• onboarding — sign-up steps shown in the hub. It is empty for now, so the hub shows none.

Feishu application

1. Create an enterprise self-built web app.
2. Set the homepage URL to the public HTTPS origin. Include /.
3. Add that exact homepage to Redirect URLs. Do not add a query or a hash.
4. Add the host to H5 trusted domains.
5. Publish the version to the organisation.

Coolify

Use Railpack and Node 22.

Set VITE_FEISHU_APP_ID at build time and at run time. Set FEISHU_APP_ID, FEISHU_APP_SECRET, and SESSION_SECRET at run time. Set VITE_MOCK_USER to 0 in production. Keep secrets out of the repository.

Current deployment

The app is deployed to https://feishu-hub.superbonfire.tech through Coolify on our Tencent Cloud VPS.