owlmeans

PK-based supervisor authentication — a development-only login where a holder of one of the project's trusted private keys mints a token for any user id/email (registering them on first use), bypassing external IdPs. Primary use is end-to-end tests. Covers appendSupervisorAuth (server + web), the supervisor plugin, and the @owlmeans/test-ui helpers. Use when wiring or testing supervisor auth.

How to use @owlmeans/web-auth — web client auth plugins that register into @owlmeans/client-auth/manager. Currently ships the development-only PK-based supervisor login form (appendSupervisorAuth). Auto-invoked when importing @owlmeans/web-auth.

Discovery-first, reuse-first workflow for OwlMeans projects. Use BEFORE planning or building any feature, before proposing a third-party library or a custom solution, and after writing code. Find an existing @owlmeans/* package or existing code first; extend before writing new; simplify what you write.

How to scaffold a new OwlMeans Common project — the @owlmeans/create-app CLI (npm/bun/yarn create), its flags, what it generates, and the manual alternative. Use when asked to create/bootstrap/start a new OwlMeans app or set up a fresh project.

Discovery-first, reuse-first workflow for OwlMeans projects. Use BEFORE planning or building any feature, before proposing a third-party library or a custom solution, and after writing code. Find an existing @owlmeans/* package or existing code first; extend before writing new; simplify what you write.

How to scaffold a new OwlMeans Common project — the @owlmeans/create-app CLI (npm/bun/yarn create), its flags, what it generates, and the manual alternative. Use when asked to create/bootstrap/start a new OwlMeans app or set up a fresh project.

How to use @owlmeans/api — HTTP client service (axios-based) used to call entrypoints across services. Auto-invoked when importing the API service or when ctx.entrypoint(...).call() under the hood is involved.

How to use @owlmeans/api-config — module declarations for fetching API/service configuration at runtime. Auto-invoked when importing api-config types or modules.

How to use @owlmeans/native-client — the React Native app bootstrap package. Provides makeContext() to wire context/auth/permissions/router/db, AppConfig for multi-environment service routing, and useContext() hook. Auto-invoked when importing from native-client or setting up a React Native OwlMeans app.

How to use @owlmeans/native-db — React Native AsyncStorage-backed ClientDb adapter. Use makeNativeDbService() to create a multi-store persistent key/value service, or appendNativeDbService() to register it on a context. Auto-invoked when importing from native-db or wiring local storage in a React Native app.

How to use @owlmeans/native-panel — React Native Material Design 3 panel/UI component library built on react-native-paper. Use PanelApp as the root wrapper; re-exports makeContext, common panel helpers, and form/modal/list components. Auto-invoked when importing from native-panel or building React Native admin/dashboard UIs.

How to use @owlmeans/native-router — React Router Native adapter implementing the @owlmeans/router contract. Use appendNativeRouter() to register a memory-router-based router service on a context. Auto-invoked when importing from native-router or wiring navigation in a React Native OwlMeans app.

How to use @owlmeans/native-client — the React Native app bootstrap package. Provides makeContext() to wire context/auth/permissions/router/db, AppConfig for multi-environment service routing, and useContext() hook. Auto-invoked when importing from native-client or setting up a React Native OwlMeans app.

How to use @owlmeans/native-db — React Native AsyncStorage-backed ClientDb adapter. Use makeNativeDbService() to create a multi-store persistent key/value service, or appendNativeDbService() to register it on a context. Auto-invoked when importing from native-db or wiring local storage in a React Native app.

How to use @owlmeans/native-panel — React Native Material Design 3 panel/UI component library built on react-native-paper. Use PanelApp as the root wrapper; re-exports makeContext, common panel helpers, and form/modal/list components. Auto-invoked when importing from native-panel or building React Native admin/dashboard UIs.

How to use @owlmeans/native-router — React Router Native adapter implementing the @owlmeans/router contract. Use appendNativeRouter() to register a memory-router-based router service on a context. Auto-invoked when importing from native-router or wiring navigation in a React Native OwlMeans app.