Zachri Studio Soonpage docs
Install
  1. Overview
  2. Install
  3. Using Soonpage
  4. Settings
  5. Security
  6. Privacy
  7. Changelog
  8. Support and licence

Install

Install Soonpage from npm in three steps. The free plan needs no account or key.

  1. Install the package in your site’s folder:
    npm i @zachristudio/soonpage
    npm 7 or later also installs the peer packages it needs (React, Kumo and Phosphor icons), which an EmDash site already has.
  2. Register it in astro.config.mjs. Soonpage has two parts: soonpagePlugin() goes inside emdash(), and soonpage(), the middleware that shows the page, goes after emdash().
    import { defineConfig } from "astro/config";
    import react from "@astrojs/react";
    import emdash from "emdash/astro";
    import { soonpage, soonpagePlugin } from "@zachristudio/soonpage";
    
    export default defineConfig({
      output: "server",
      integrations: [
        react(),
        emdash({
          // your database and storage settings
          plugins: [soonpagePlugin()],
        }),
        soonpage(), // list it after emdash()
      ],
    });
  3. Restart or redeploy. Soonpage appears in the admin sidebar. Your site stays live until you choose Hide site. See Using Soonpage.

From the EmDash registry

Searching the registry for “coming soon” or “maintenance” finds Soonpage: Coming Soon & Maintenance Mode. That entry is a setup guide: installing it adds a Soonpage setup page to your admin with these same steps. Soonpage itself always comes from npm, because showing a page instead of your site needs middleware, which only a trusted plugin can add. You can uninstall the guide once Soonpage is running.

Prerendered pages

Soonpage works on pages your server renders on demand. Prerendered pages are served as static files and never reach it, so they stay visible while the site is hidden. Use output: "server", or make sure the pages you want hidden are rendered on demand.

Hosting

Nothing extra to configure: the package is public, so every host installs it like any other dependency. Commit package.json and your lockfile, then deploy as usual.

The per-visitor signup limit needs the visitor’s IP address. On Cloudflare that works on its own; on other hosts, see Spam protection.

Updating

npm install @zachristudio/soonpage@latest

Then redeploy. Your page, settings and subscribers carry over. Check the changelog first.