Skip to content

Standalone Gate

A copy-paste React access screen for the fastest possible integration — wrap your app, pass a hash, done. Zero dependencies.

Routing & LayoutWrapper Aliasquickstart

Best used for The fastest possible integration — wrapping an entire app with minimal configuration.

For the two-line integration: generate a hash, wrap your app, ship it. No config to reason about.

// Usage

Minimal setup

<StandaloneGate expectedHash={process.env.NEXT_PUBLIC_KNOCK_HASH}>
  <YourApp />
</StandaloneGate>
FIG.01Demo code: 4242
Installation

Add this block to your project

Recommended

npx shadcn@latest add @knock-codes/standalone-gate

Also installs

  • Knock Codes Core
  • Knock Codes Types
  • useKnockCodes
  • cx (classname helper)
  • Gate Wrapper
  • PIN Input
  • Knock Codes

These install together as one atomic unit — even a presentational or read-only piece needs the full verification stack (hook, types, core) behind it to actually run.

Files created (12)

  • components/knock-codes/core/hash.ts
  • components/knock-codes/core/verify.ts
  • components/knock-codes/core/session.ts
  • components/knock-codes/core/storage.ts
  • components/knock-codes/react/types.ts
  • components/knock-codes/react/useKnockCodes.ts
  • components/knock-codes/react/KnockCodesContext.tsx
  • components/knock-codes/react/cx.ts
  • components/knock-codes/react/GateWrapper.tsx
  • components/knock-codes/react/PinInput.tsx
  • components/knock-codes/react/KnockCodes.tsx
  • components/knock-codes/react/StandaloneGate.tsx
Other ways

GitHub shorthand

npx shadcn@latest add trivedi-vatsal/knock-codes/standalone-gate

Copy the files by hand

  1. Open the Code tab in the preview above.
  2. Create each path listed below in your project and paste its contents in.
  3. Do the same for anything listed under “Also installs”, if present.
// Props

API reference

PropTypeDefaultDescription
expectedHashstringSHA-256 hex hash to verify against, for local mode.
verifyVerifyFnCustom async verification function, for server mode.
children *ReactNodeRendered once unlocked.
headingstring"This page is protected"Overrides just the heading — for everything else, use Knock Codes directly.
variant"page" | "inline""page"Escape hatch for embedding a demo somewhere other than a real app root — a docs page, this gallery's own preview.
autoFocusbooleantrueFocuses the code field on mount. Off in embedded previews so a newly-rendered gate can't steal focus and scroll the page.

Exactly one of expectedHash or verify is required.

Notes

Accessibility

Same access-code entry UI as Knock Codes — full keyboard and screen-reader support inherited, none of it re-implemented.

Customization

Deliberately a smaller prop surface than Knock Codes — just `expectedHash`/`verify`, `children`, an optional `heading`, and `autoFocus`. Reach for `<KnockCodes>` directly the moment you need storage/timeout/activity-tracking control.

Security & Verification

Need a hash? Use the hash generator on Getting Started — computed locally, never sent anywhere.

The honest version

Knock Codes stops casual visitors, search engines, and forwarded links. Local mode does not stop anyone who opens DevTools — the hash ships in your client bundle by design. Server mode (swap one prop) hides the hash from the client; children you already bundled are still in the JavaScript, and a forged session works unless you wire validateSession. A velvet rope, with an optional real lock. Never marketed as more than that.

// Ready-made

Used in these templates

Want the whole screen instead of assembling it yourself? These templates already build on this block.

// Compose with

Blocks that pair well with this one

These combine naturally with this block, whether as a shared shell, a shared session, or a common fallback.