# @mappedin/mvf-facade

> The Facade extension describes the [Geometry](../types/_mappedin_mvf-core.core_geometry_geometry.GeometrySchema.html) of a [FloorStack](../modules/_mappedin_mvf-floor-stacks.html) that live on [Floors](../types/_mappedin_mvf-core.core_floors_floors.Floors

Latest version **3.0.0-beta.15** (published 2026-09-24) · UNLICENSED license · 0 weekly downloads

## Install

```sh
npm install @mappedin/mvf-facade
pnpm add @mappedin/mvf-facade
yarn add @mappedin/mvf-facade
bun add @mappedin/mvf-facade
```

## Health

**Score 60/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 3.0.0-beta.15 |
| Published | 2026-09-24 |
| First published | 2025-08-14 |
| Weekly downloads | 0 |
| License | UNLICENSED |
| TypeScript types | none |
| Module format | ESM |
| Dependencies | 4 |
| Unpacked size | 17.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Mappedin |
| Maintainers | mappedin-ops, mappedin-engineering |

## Links

- npm: https://www.npmjs.com/package/@mappedin/mvf-facade
- Homepage: https://developer.mappedin.com/
- npm.io page: https://npm.io/package/@mappedin/mvf-facade

## Dependencies (4)

- [@sinclair/typebox](https://npm.io/package/@sinclair/typebox.md) 0.33.22
- [@mappedin/mvf-core](https://npm.io/package/@mappedin/mvf-core.md) 3.0.0-beta.15
- [@mappedin/safe-types](https://npm.io/package/@mappedin/safe-types.md) ^1.0.1
- [@mappedin/mvf-floor-stacks](https://npm.io/package/@mappedin/mvf-floor-stacks.md) 3.0.0-beta.15

## Recent versions

- 3.0.0-beta.15 (latest) — 2026-09-24
- 3.0.0-beta.11 — 2026-03-31
- 3.0.0-beta.10 — 2025-09-26
- 1.0.0-beta.8 — 2025-08-22
- 1.0.0-beta.7 — 2025-08-14

## README

# MVF Facade

The Facade extension describes the [Geometry](../types/_mappedin_mvf-core.core_geometry_geometry.GeometrySchema.html) of a [FloorStack](../modules/_mappedin_mvf-floor-stacks.html) that live on [Floors](../types/_mappedin_mvf-core.core_floors_floors.FloorsSchema.html) not part of the stack. For example (and typically), the [Outdoors](../modules/_mappedin_mvf-outdoors.html) floor may have one or more polygons that represent the facade of a building, which is grouped into a single FloorStack with it's inner floors.

This is separate from the geometry of the `Floors`, which will usually be the exterior walls only. The `facade` may include extra geometry, such as a representation of the roof. As they are normal `Geometry` objects, the `facade` may get things like [styles](../modules/_mappedin_mvf-default-style.html), [floor images](../modules/_mappedin_mvf-floor-images.html), or even a [Location](../modules/_mappedin_mvf-locations.html) describing the building as a whole attached to it.

## Schema

The facade extension adds a `facade` property to the MVF, which is a record of [FloorStackId](../types/_mappedin_mvf-floor-stacks.index.FloorStackId.html) to FacadeProperties.

### FacadeProperties

FacadeProperties are [WithGeometryAnchors](../types/_mappedin_mvf.core.WithGeometryAnchors.html) objects, with at least one anchor, plus a `id` property that is a FacadeId.

A facade may include anchors on multiple floors, if, for some reason, it has representation on them, but typically they will be on the [Outdoors](../modules/_mappedin_mvf-outdoors.html) floor.

### FacadeIntegrityError

FacadeIntegrityError is a simple object with a single property, `id`, which is the [FloorStackId](../types/_mappedin_mvf-floor-stacks.index.FloorStackId.html) of the facade.

---
_Source: https://npm.io/package/@mappedin/mvf-facade · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._