Hono

Installation

Install Hono.

npm install hono --save-dev

Setup and Security

Make sure you've set up your database adapter first (see Database Adapters).

The Hot Updater handler does not include built-in authentication. Keep update-check routes public for React Native clients, but always protect bundle management routes before mounting the handler:

• Public: /hot-updater/app-version/*, /hot-updater/fingerprint/*
• Optional public diagnostics: /hot-updater/version
• Protected: /hot-updater/api/*

Import the Hot Updater instance, protect /api/*, and mount it to your Hono app:

import { Hono } from "hono";
import { bearerAuth } from "hono/bearer-auth"; 
import { hotUpdater } from "./hotUpdater"; 

const app = new Hono();

app.use("/hot-updater/api/*", bearerAuth({ token: process.env.API_KEY! })); 

app.mount("/hot-updater", hotUpdater.handler); 

export default app;

If you set routes: { updateCheck: true, bundles: false }, /hot-updater/api/* is not mounted and /hot-updater/version stays available. Set version: false as well if you want update-check-only routes.

Set your API key in environment variables:

API_KEY=your-secret-api-key

Configure the CLI to include the API key when deploying bundles:

import { standaloneRepository } from "@hot-updater/standalone";

export default defineConfig({
  // ...
  database: standaloneRepository({
    baseUrl: "http://localhost:3000/hot-updater",
    commonHeaders: {
      Authorization: `Bearer ${process.env.API_KEY}`,
    },
  }),
});

API Endpoints

The server automatically creates these endpoints:

React Native Setup

Configure your React Native app to connect to this server.

import { HotUpdater } from '@hot-updater/react-native';

export default HotUpdater.wrap({
  baseURL: 'http://localhost:3000/hot-updater', 
  updateStrategy: 'appVersion', // or "fingerprint"
  updateMode: "auto",
  fallbackComponent: ({ progress, status }) => (
    // ... Custom loading UI
  ),
  onError: error => {
    // ... Error handling
  },
})(App);