Authlance Extension Guide

The loop-scaffold workspace comes prewired with every major Authlance dashboard surface:
route discovery, document providers, prerender caching, contextual table actions, layout slots, and more.

To make the extension system easier to learn, the original monolithic guide has been split into three focused chapters.
All examples use the fictional Taco Fish Stand extension (@eltacofish/dashboard) to illustrate real-world patterns.

Explore the Source Code

The full Authlance Dashboard source code lives in the main repository:

• Dashboard source:
• Scaffold workspace used in this guide:
• Framework origins: The dashboard began from a manual fork of Eclipse Theia, with significant rewrites to support Authlance’s modular extension model.

If you're extending the dashboard, we strongly recommend browsing these repositories in parallel with this guide.

Choose Your Chapter

Pick the chapter that aligns with what you are building:

1. Layout, Branding & Operations
   Covers layout contracts, theming, publishing custom packages, and setting up a local development environment.

2. Routing & Metadata
   Explains route discovery, navigation groups, and SEO hooks at both the route and dashboard level.

3. Prerender & Runtime Contributions
   Explore prerender contexts, cache contributions, user/group actions, and header/sidebar extension points.

About This Guide

Each chapter stands alone, but reading them in order provides a complete tour of Authlance’s extension seams:

• Route contributions
• Document providers
• Prerender and cache contributions
• Table and contextual actions
• Packaging and workspace structure

Mastering these extension points allows you to ship fully branded, deeply integrated Authlance dashboards—just like the Taco Fish Stand example—while maintaining full control over your user experience without needing to fork the core dashboard.