static

generate

Use this function when SSG should be generated from another module, such as a Vite plugin. This function's should be passed the paths of the entry module and Qwik City Plan.

export declare function generate(
  opts: StaticGenerateOptions,
): Promise<StaticGenerateResult>;

Parameter	Type	Description
opts	StaticGenerateOptions

Returns:

Promise<StaticGenerateResult>

Edit this section

StaticGenerateOptions

export interface StaticGenerateOptions extends StaticGenerateRenderOptions

Extends: StaticGenerateRenderOptions

Property	Type	Description
basePathname?	string	(Optional) Defaults to /
qwikCityPlanModulePath	string	Path to the Qwik City Plan module exporting the default @qwik-city-plan.
renderModulePath	string	Path to the SSR module exporting the default render function. In most cases it'll be ./src/entry.ssr.tsx.
rootDir?	string	(Optional)

Edit this section

StaticGenerateRenderOptions

export interface StaticGenerateRenderOptions extends RenderOptions

Extends: RenderOptions

Property	Type	Description
emit404Pages?	boolean	(Optional) Set to false if the static build should not write custom or default 404.html pages. Defaults to true.
emitData?	boolean	(Optional) Set to false if the generated q-data.json data files should not be written to disk. Defaults to true.
emitHtml?	boolean	(Optional) Set to false if the generated static HTML files should not be written to disk. Setting to false is useful if the SSG should only write the q-data.json files to disk. Defaults to true.
exclude?	string[]	(Optional) Defines file system routes relative to the source routes directory that should not be static generated. Accepts wildcard behavior. This should not include the "base" pathname. exclude always takes priority over include.
include?	string[]	(Optional) Defines file system routes relative to the source routes directory that should be static generated. Accepts wildcard behavior. This should not include the "base" pathname. If not provided, all routes will be static generated. exclude always takes priority over include.
log?	'debug'	(Optional) Log level.
maxTasksPerWorker?	number	(Optional) Maximum number of tasks to be running at one time per worker. Defaults to 20.
maxWorkers?	number	(Optional) Maximum number of workers to use while generating the static pages. Defaults to the number of CPUs available.
origin	string	The URL origin, which is a combination of the scheme (protocol) and hostname (domain). For example, https://qwik.builder.io has the protocol https:// and domain qwik.builder.io. However, the origin does not include a pathname.The origin is used to provide a full URL during Static Site Generation (SSG), and to simulate a complete URL rather than just the pathname. For example, in order to render a correct canonical tag URL or URLs within the sitemap.xml, the origin must be provided too.If the site also starts with a pathname other than /, please use the basePathname option in the Qwik City config options.
outDir	string	File system directory where the static files should be written.
sitemapOutFile?	string \| null	(Optional) File system path to write the sitemap.xml to. Defaults to sitemap.xml and written to the root of the outDir. Setting to null will prevent the sitemap from being created.

Edit this section

StaticGenerateResult

export interface StaticGenerateResult

Property	Modifiers	Type	Description
duration		number
errors		number
rendered		number
staticPaths		string[]

Edit this section