Install
Install Soonpage from npm in three steps. The free plan needs no account or key.
- Install the package in your site’s folder:
npm 7 or later also installs the peer packages it needs (React, Kumo and Phosphor icons), which an EmDash site already has.npm i @zachristudio/soonpage - Register it in
astro.config.mjs. Soonpage has two parts:soonpagePlugin()goes insideemdash(), andsoonpage(), the middleware that shows the page, goes afteremdash().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() ], }); - 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.