Beian

Beian is a Nuxt 3 static-site template that generates a compliant placeholder website for China's MIIT ICP filing review, auto-filling content from online sources.

What is Beian?

Beian is an open-source Nuxt 3 template that builds a static website containing the site name, description, and ICP filing number required by China's Ministry of Industry and Information Technology (MIIT) during website filing review. It takes three configuration values from the nuxt.config.ts file and outputs a ready-to-deploy static site by fetching live articles from the Juejin frontend hot list. The repository is maintained by loo2k and includes a demo at loo2k.github.io/beian.

Key Features

• Three-line setup — Edit appConfig with the site title, description, and filing number; everything else is handled automatically.
• Real content fetching — The generate step pulls the 10 hottest frontend articles from Juejin (via server/api routes), ensuring the placeholder site has fresh content instead of blank pages.
• Pure static output — Run npm run generate to produce a dist folder that can be hosted on any static server, keeping deployment cost low.
• Region-approved — The template passed Guangdong Province's filing review in October 2022, so it can be reused with confidence in that province.
• Customizable data source — Modify server/api/articles/index.ts or server/api/articles/[id].ts to scrape content from a different website.
• Modern stack — Built with Vue 3, Vite, and Nuxt 3, giving developers familiar tooling.

Who is it for?

• Website owners who need a compliant placeholder page while waiting for ICP/公安 filing approval — they just fill in their site details and deploy.
• Developers managing multiple domains who want a repeatable, fast way to produce review-ready static pages for each new domain.
• Agencies or consultants handling filing for many different clients — the template reduces each submission to a three-line configuration change.

How does Beian work?

First, clone the repository and run npm install with Node.js 14 or later. Then edit the appConfig property in nuxt.config.ts to set the required site title, description, and ICP number. Finally run npm run generate and upload the resulting files in the dist directory to your web host.

What can you do with Beian?

• Filing applicants: Generate a static website that shows the exact information MIIT reviewers expect (site name, description, filing number) and deploy it before review.
• Developers with multiple sites: Create placeholder pages for every domain in minutes by cloning and adjusting the config for each instance.
• Open-source contributors: Adapt the template for other provinces' filing rules and submit a PR, since the current repo only documents Guangdong's process.

FAQ

Is Beian free to use?

Yes, the template is open source and free. The only cost is for the static hosting where you deploy the generated dist folder.

Will Beian guarantee filing approval?

No. The template passed Guangdong Province's review in October 2022, but filing policies change and other provinces may have stricter or additional requirements. Authors note they cannot verify every province's process.

What's the difference between ICP备案 and 公安备案?

ICP备案 is the MIIT record required for websites hosted in mainland China; 公安备案 is an additional public security filing. Beian supports both by generating a static page that satisfies the common review criteria.

Can I change the scraped content source?

Yes, edit the files under server/api/articles to point to a different feed or API. During generation, Nuxt 3 fetches the articles through those server routes and bundles them into the static output.