# @appkit/dek-lib

The DEK board runtime. Provides `BoardProvider`, the component hierarchy (`Board`, `Zone`, `Component`, `Router`), and a set of built-in plugins (base, calendar, clock, home-assistant, weather, desktop, sample).

## Installation

```bash
npm install @appkit/dek-lib
```

## Usage

```typescript
import { authorize, Board, BoardProvider } from '@appkit/dek-lib';

const token = await authorize('user@example.com', 'password');

<BoardProvider authToken={token}>
  <Board />
</BoardProvider>
```

## Documentation

- [Board Configuration](docs/config.md) — Board/zone/layout config format reference
- [Built-in Plugins](docs/built-in-plugins.md) — base, calendar, clock, home-assistant, weather, desktop, sample
- [Board System](../../docs/board-system.md) — How the board system works (layout format, zones, navigation)

## Public API

```typescript
// Components
export { Board, BoardProvider, Zone, Component, Router, RouteResolver, Command, CommandGroup };

// Utilities
export { authorize };             // Login and get an auth token
export { loadCustomDekPlugin };   // Load a plugin from remote code
export { useAuthorization };      // Hook: current auth state

// Types
export type { PreviewConfig };
```