useIsHost

useIsHost is the boolean convenience over useHostMode: it returns true exactly when the mode is "host".

Note the asymmetry: it is false both while detection is still pending and when the app genuinely runs standalone. That makes it ideal for gating host-only UI (a notifications button, a deep-link menu), which should stay hidden until the host is confirmed. If you need to distinguish "still detecting" from "definitely standalone", use useHostMode directly.

Usage

import { useIsHost } from "@use-truapi/react";

function Toolbar() {
  const isHost = useIsHost();

  return (
    <nav>
      <button type="button">Refresh</button>
      {isHost && <button type="button">Enable reminders</button>}
    </nav>
  );
}

<script setup lang="ts">
import { useIsHost } from "@use-truapi/vue";

const isHost = useIsHost();
</script>

<template>
  <nav>
    <button type="button">Refresh</button>
    <button v-if="isHost" type="button">Enable reminders</button>
  </nav>
</template>

See also

• useHostMode is the three-state variant for when the pending window matters.
• useNotifications is a host-only API you would typically gate with this hook.

API reference

React

function useIsHost(): boolean;

False while detection is pending — gate host-only UI on useHostMode() if the distinction matters.

Returns

boolean

Vue

function useIsHost(): ComputedRef<boolean>;

False while detection is pending — gate host-only UI on useHostMode() if the distinction matters.

Returns

ComputedRef<boolean>