Skip to content

Self-hosted personal gallery application with online photo management and albums, supporting Live/Motion Photos, EXIF parsing, geolocation recognition, and an explore map.

2.5 KB
Raw Blame

Development debug tools

::: info Development only The floating debug entry appears globally under pnpm dev. Production builds remove the panel import and disable debug reads, writes, and registrations. ?debug=1 opens the panel; the previous ?queueDebug=1 link also enables the queue preview in development. Neither parameter activates production debugging. :::

  • Drag the entry to dock it against the nearest edge or corner.
  • Drag a window header to move it; drag its edges or corners to resize it.
  • Use the header buttons to maximize, restore or close the window. Double-clicking the header also toggles maximization.
  • Press Escape to close the window.

Register page controls

const enabled = useDebugValue<boolean>('feature:enabled', false)
const count = useDebugValue<number>('feature:count', 10)

useDebugSection(() => ({
  id: 'my-feature',
  route: '/my-page',
  title: 'My feature',
  controls: [
    {
      key: 'feature:enabled',
      label: 'Enable preview',
      type: 'switch',
      default: false,
    },
    {
      key: 'feature:count',
      label: 'Count',
      type: 'number',
      default: 10,
      min: 0,
      max: 100,
    },
    {
      key: 'feature:status',
      label: 'Status',
      type: 'status',
      value: enabled.value ? 'Enabled' : 'Disabled',
    },
  ],
}))

Supported controls: switch, select (with options), number, text, status (read-only value), and action (with an action callback). Use useDebugValue for reactive reads/writes, or useDebugStore().get/set for imperative access. Configuration persists in local storage. Route controls are scoped to their page lifecycle and filtered by exact route path.

::: warning Guard expensive fixtures In production, reads return defaults and writes are ignored. Wrap expensive mock generation in if (import.meta.dev) so it can be removed from the build. :::

Reuse the floating window

app/components/ui/FloatingWindow/FloatingWindow.vue is independent of the store. Use v-model for visibility. An optional stable id persists geometry and maximized state. allowOverflow defaults to true; set it to false to keep the window inside the viewport. Configure minWidth, minHeight, maxWidth, maxHeight, initialX, initialY, initialWidth, and initialHeight. Viewport limits take precedence over minimum dimensions on small screens. Maximization fills the viewport and preserves the normal rect. Slots: default content, title, actions, and footer.

Validation: pnpm lint.