Templates

Eodash ships with ready made templates so a dashboard can start from a working configuration. getBaseConfig provides a complete base configuration to override, as well as a set of named templates for most common use cases.

getBaseConfig

getBaseConfig returns a complete assembled Eodash configuration, with the overrides you pass deep merged on top. It is exported from @eodash/eodash/templates:

import { getBaseConfig } from "@eodash/eodash/templates";

export default getBaseConfig({
  id: "my-dashboard",
  stacEndpoint: "https://eoxhub-workspaces.github.io/eoxhub-test-catalog/catalog/catalog.json",
  brand: { name: "My Dashboard" },
});

The override is merged recursively, so a nested value such as brand.name replaces only that field while the rest of the base is kept. Arrays are replaced rather than concatenated, so an array you pass - widgets, collectionsPalette, or supportedUpscalingEndpoints - overrides the base array in full.

The return value is a plain configuration object. Export it directly, or pass it to createEodash when the configuration needs access to the store.

Built-in templates

The package exports four templates, each a Template describing a grid layout:

Template	Recommended For	Layout	Source
lite	Static STAC Catalogs	Compact layout for non-experts: map with date picker, layer control, STAC info, and tools.	lite.js
explore	Dynamic STAC APIs	Catalog-driven layout pairing the item catalog and layer control with an interactive map.	explore.js
expert	Advanced Analysis	The lite layout extended with charts and a processing widget.	expert.js
compare	Multi-dataset Comparison	Layout for comparing datasets, with charts, processing, and tools.	compare.js

Template Selection Rule of Thumb

• For Static STAC Catalogs (hierarchical catalog.json without search API), use lite (default). Static catalogs do not need item query filters or full-text item discovery catalogs.
• For Dynamic STAC APIs (api: true / searchable item endpoints), use explore to leverage EodashItemCatalog and dynamic item discovery.

Import a template and assign it to template:

import { lite } from "@eodash/eodash/templates";

export default {
  id: "my-dashboard",
  stacEndpoint: "https://eoxhub-workspaces.github.io/eoxhub-test-catalog/catalog/catalog.json",
  brand: { name: "My Dashboard" },
  template: lite,
};

Multiple templates

Assign several templates to the templates map to offer more than one layout. The EodashLayoutSwitcher lets the reader move between them:

import { lite, explore } from "@eodash/eodash/templates";

export default {
  id: "my-dashboard",
  stacEndpoint: "https://eoxhub-workspaces.github.io/eoxhub-test-catalog/catalog/catalog.json",
  brand: { name: "My Dashboard" },
  templates: { lite, explore },
};

A template is a plain object, so it can be adjusted before use - for example, to change a widget's properties or its placement on the grid. See the Configuration guide for the shape of a template, and the Widgets guide for the widgets each one contains.