# UNDRR Asset Library > The UNDRR asset library at assets.undrr.org — a versioned, shared collection of web assets for UNDRR web properties, distributed via CDN. Logos, fonts, embeddable widgets, documentation, and standalone data applications. ## Start here - [Asset library homepage](https://assets.undrr.org/): A short introduction and links to key asset categories - [Complete sitemap](https://assets.undrr.org/sitemap.html): Searchable file browser; directory links use fragments such as `#mangrove`, `#fonts`, `#logos`, and `#favicons` - [Developer README](https://assets.undrr.org/README.md): Repository structure, local development, and hosting architecture - [Coding Agent Guide](https://assets.undrr.org/AGENTS.md): Machine-readable specifications, token contracts, and repository conventions for AI coding agents - [Contributing](https://assets.undrr.org/CONTRIBUTING.md): Asset conventions, validation, and deployment workflow Use direct Markdown URLs when retrieving documentation; the homepage does not render the root README. The sitemap is the full inventory, while this file highlights useful entry points. ## Asset usage Use canonical URLs of the form `https://assets.undrr.org/` without `/static/`. For local previews, replace the origin with `http://localhost:8000`; for testing use `https://test.undrr-asset-library.pages.dev`. The legacy `/testing/static/` path on the production host serves production content. Preserve published version directories when contributing. Pin consumers to an available version, and read its documentation before choosing file paths. Mangrove uses `mangrove/{version}/` (without a `v` prefix); `mangrove/latest/` is a mutable development build. Other assets follow their own existing directory conventions. - [Mangrove](https://assets.undrr.org/sitemap.html#mangrove): Shared design styles and components; versioned packages are populated during the build. See [Mangrove README](https://assets.undrr.org/mangrove/README.md), upstream [Mangrove llms.txt](https://mangrove.undrr.org/llms.txt), [component index](https://mangrove.undrr.org/ai-components/index.json), [design tokens](https://mangrove.undrr.org/tokens.json), [CSS utilities](https://mangrove.undrr.org/ai-components/utilities.json), and the [editorial manual](https://mangrove.undrr.org/llms-editorial-manual.txt) for UI copy. - [Fonts](https://assets.undrr.org/fonts/README.md): Available typefaces and font-loading guidance - [Logos](https://assets.undrr.org/sitemap.html#logos): Brand marks and available variants - [Favicons](https://assets.undrr.org/favicons/README.md): Brand directories, icon sizes, recommended markup, and regeneration instructions ### Mangrove 2.0 theme bundles and token rules Mangrove 2 provides single-theme CSS bundles at `https://assets.undrr.org/mangrove/{version}/css/`: - `style.css` (UNDRR primary theme) - `style-preventionweb.css` (PreventionWeb) - `style-mcr.css` (MCR2030) - `style-irp.css` (IRP) - `style-delta.css` (DELTA Resilience) - `style-all.css` (All themes; required if runtime theme switching via `.mg-theme-*` is needed) Key token rules for Mangrove consumers: - **Colour tokens are sRGB triples**: Wrap channel variables in `rgb()`, e.g. `color: rgb(var(--mg-color-interactive));` or `background: rgb(var(--mg-color-interactive) / 0.1);`. Bare `var(--mg-color-...)` is invalid CSS for channel triples and will be silently ignored. - **Font roles**: Name roles rather than typefaces: `var(--mg-font-family-text)`, `-heading`, `-display`, `-ui`, `-code`. - **Z-index layers**: Use `--mg-z-index-*` tokens (`-behind`, `-nav`, `-sticky`, `-nav-toggle`, `-header`, `-drawer`, `-dropdown`, `-modal`, `-toast`). Derive backdrops via `calc(var(--mg-z-index-drawer) - 1)`. - **Skip links**: Use `Skip to content` with `tabindex="-1"` on `
`. ## Documentation - [UNDRR writing guides](https://assets.undrr.org/docs/editorial-guides/README.md): Index of content-type writing guides for undrr.org and PreventionWeb, and how they relate to the Mangrove editorial manual and internal guidance - [News writing guide](https://assets.undrr.org/docs/editorial-guides/news.md): News types, titles, structure, quotes and tone for news items - [Events writing guide](https://assets.undrr.org/docs/editorial-guides/events.md): Titles, standard sections and post-event updates for event pages - [Publications writing guide](https://assets.undrr.org/docs/editorial-guides/publications.md): How to summarize a report or document: the two-paragraph abstract structure, first sentence for the PreventionWeb email alert, DRR angle - [Blogs writing guide](https://assets.undrr.org/docs/editorial-guides/blogs.md): What an edited blog post looks like, including the first-person rule for guest authors - [Metadata guidance](https://assets.undrr.org/docs/editorial-guides/metadata.md): Choosing themes, hazards and countries, with current term names - [Taxonomy reference](https://assets.undrr.org/docs/editorial-guides/taxonomy.md): Themes, hazards, countries, regions and groupings with their term IDs, generated from the production taxonomy, with the queries to regenerate it - [Writing guides methodology](https://assets.undrr.org/docs/editorial-guides/methodology.md): Where the December 2025 baseline figures come from, their limits, and how the guides are maintained - [Instructions for AI writing assistants](https://assets.undrr.org/docs/editorial-guides/ai-agent-instructions.md): Which guide answers which question, and the priority order when guidance conflicts - [Using the writing guides with an AI assistant](https://assets.undrr.org/docs/editorial-guides/agent-recipes.md): Which files to upload to an AI tool that can't connect to SharePoint or fetch URLs, with ready-made setups (files, instructions and starter prompts) for common editorial jobs - [Building landing pages (Mangrove)](https://mangrove.undrr.org/llms-page-building.txt): Page building for the UNDRR Drupal Gutenberg block editor, with the Drupal Gutenberg integration guide: custom blocks, attributes, current markup and landing page patterns. Replaces the Gutenberg content guide and markup samples formerly published here - [Search widget editor configuration (Mangrove)](https://mangrove.undrr.org/llms-search-widget.txt): Configuring the UNDRR Search Widget block: settings, query syntax, field names and taxonomy term IDs. Replaces the search widget reference formerly published here ## Embeddable widgets - [SFM Quick Facts Widget](https://assets.undrr.org/projects/sfm-quick-facts/README.md): Sendai Framework Monitor quick facts widget, embeddable in Drupal and other sites - [Cookie Banner](https://assets.undrr.org/cookie-banner/v1/README.md): Cookie consent configuration and integration using vanilla-cookieconsent ## Data - [Country Pages Data](https://assets.undrr.org/projects/pw-country-pages/data/README.md): Per-country disaster risk data (JSON), versioned and segmented by ISO country code - [Hazard Information Profiles](https://assets.undrr.org/projects/hips/README.md): Interactive tools for UNDRR Hazard Information Profiles (HIPs) ## Projects overview - [All projects](https://assets.undrr.org/projects/README.md): Index of standalone applications and data resources in this asset library ## Editing this repository Edit `index.html` for the landing page, `scripts/readme-template.html` for generated README viewers, and `scripts/sitemap-template.html` for the file browser. `npm run deploy-index` preserves the root homepage and app-owned indexes. Regenerate documentation pages and the sitemap with the scripts described in the developer README instead of editing generated files. Keep this file focused on guidance and entry points; maintain detailed inventories in the sitemap and category READMEs.