# Guides index

Use this page as the editorial entry point for AsukaDesigner v1.

The guides complement the generated TypeDoc reference in `docs/` by focusing on setup, integration patterns, and recommended usage.

## Start here

- [Installation](./installation.md)
- [Quick start](./quick-start.md)
- [API overview](./api-overview.md)

## Configuration and UI structure

- [Layout](./layout.md)
- [Responsive layout](./responsive.md)
- [Permissions](./permissions.md)
- [Fonts](./fonts.md)
- [Internationalization](./i18n.md)
- [Translation keys reference](./translation-keys.md)
- [Production observability](./observability.md)
- [Known limitations](./known-limitations.md)
- [Overlays and mount targets](./overlays.md)
- [License](./license.md)
- [License API](./license-api.md)
- [Built-in modules](./modules-built-in.md)
- [3D camera module and API](./camera-module-and-api.md)
- [Physical measurements and print production](./physical-measurements.md)
- [Element variations](./variations.md)
- [Generic 3D spatial assembly](./spatial-assembly.md)
- [Custom modules](./modules-custom.md)

The built-in Upload / Images workflow now supports configurable file handling strategies, including local object URLs, Base64 data URLs, and remote endpoint uploads.

## Runtime behavior and persistence

- [State and persistence](./state-and-persistence.md)
- [Mixed 2D/3D export-import browser demo](../EXPORT_IMPORT_2D_3D_DEMO.md)
- [Events and listeners](./events-and-listeners.md)

## Working snippets

- [Examples](./examples.md)

## Suggested reading order

1. [Installation](./installation.md)
2. [Quick start](./quick-start.md)
3. [API overview](./api-overview.md)
4. [Layout](./layout.md)
5. [Responsive layout](./responsive.md)
5. [Permissions](./permissions.md)
6. [Built-in modules](./modules-built-in.md)
7. [Custom modules](./modules-custom.md)
8. [Fonts](./fonts.md)
9. [Internationalization](./i18n.md)
10. [Translation keys reference](./translation-keys.md)
11. [Overlays and mount targets](./overlays.md)
12. [License](./license.md)
13. [License API](./license-api.md)
14. [State and persistence](./state-and-persistence.md)
15. [Physical measurements and print production](./physical-measurements.md)
16. [Element variations](./variations.md)
17. [Events and listeners](./events-and-listeners.md)
18. [Examples](./examples.md)


Additional topics covered across the guides include upload strategies, state restoration at initialization, shell sizing, and runtime pricing helpers.

- Menu labels can be translated through dynamic keys resolved as `menu.<id>` then `menu.<kind>`, with `label` as fallback.

Additional topics covered in the current guides include explicit boot strategies, full product/session replacement, layout conversion helpers, and structured debug mode.

The layout guide also explains the difference between **zone rendering types** (`default`, `panels`, `inline`) and **item opening types** (`floating`, `modal`, `drawer`, `popover`, `inline`).

The layout and API overview guides also document the bottom **view pagination** options, including how to disable it or force `thumbnails`, `dots`, or `numbers` mode.

- [Render engines and 3D-ready views](./render-engines.md)