@buoy/core

Floating dev tools launcher and host provider for React Native apps.

Install

pnpm add @buoy/core @buoy/shared-ui

Quick Start

import { AppHostProvider, FloatingMenu } from '@buoy/core';
import type { InstalledApp } from '@buoy/core';
import { EnvVarsModal } from '@buoy/env';

const APPS: InstalledApp[] = [
  {
    id: 'env',
    name: 'Environment',
    icon: '🛰️',
    component: EnvVarsModal,
    singleton: true,
  },
];

export function DevToolsHost() {
  return (
    <AppHostProvider>
      <FloatingMenu apps={APPS} />
    </AppHostProvider>
  );
}

Key Exports

• AppHostProvider – Context provider that manages installed dev tools.
• FloatingMenu – Cyberpunk-inspired floating entrypoint for tools.
• AppOverlay & useAppHost() – Programmatic APIs for opening tools.

The menu hosts any InstalledApp descriptor. Combine it with other @buoy/* packages for a full suite of debug panels.