Number: ${pikachu?.number}
\nTypes: ${pikachu?.types?.join(', ') || 'N/A'}
\n \n \n `;\n};\n\n// To build your site: graphql-ssg --build\n// To watch for changes: graphql-ssg","lang":"typescript","description":"This quickstart demonstrates how to install `graphql-ssg` globally, initialize a project, configure a GraphQL schema, create a TypeScript page that fetches data using the generated `Chain` client, and then build the static HTML output."},"warnings":[{"fix":"Ensure your page files (e.g., `./pages/index.ts`) contain `export default () => html` or `export default 'Hello world';`.","message":"All page files (`.js`, `.ts`) *must* include an `export default` function or string to define the page content, otherwise they will not be processed correctly by the SSG. This is the primary mechanism for content generation.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Place any logic requiring `ssg.config` or `ssg.env` directly inside the `export default` function or an `export const head` function in your page files.","message":"Configuration (`ssg.config`) and environment variables (`ssg.env`) are strictly injected and accessible *only* within `export default` and `export const head` functions of your page files. Attempting to access them outside these contexts will result in `undefined` or runtime errors, designed to prevent secret leakage.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Install globally for convenient command-line access or ensure your `package.json` scripts correctly reference the local binary (e.g., `./node_modules/.bin/graphql-ssg`).","message":"The library is primarily designed for global installation (`npm i -g graphql-ssg`) as a CLI tool. While local installation is technically possible, typical usage and commands assume global availability.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Pin `graphql-ssg` to an exact version (e.g., `0.4.8`) in your `package.json` to prevent unexpected breaking changes during updates, and review release notes carefully before upgrading.","message":"As `graphql-ssg` is in a pre-1.0 version (currently 0.4.8), its API and internal mechanics may undergo breaking changes in minor or patch releases without explicit major version increments. Users should pin exact versions for production and review changelogs for updates.","severity":"breaking","affected_versions":"<1.0.0"}],"env_vars":null,"last_verified":"2026-04-21T00:00:00.000Z","next_check":"2026-07-20T00:00:00.000Z","problems":[{"fix":"Add an `export default` statement to your page file, which should return the HTML content or a function that returns it, e.g., `export default () => html`.","cause":"A page file (e.g., `pages/my-page.ts`) does not contain an `export default` statement.","error":"Error: No default export found in file: {path-to-file}"},{"fix":"Move the code accessing `ssg.config` or `ssg.env` directly into the `export default` or `export const head` function to leverage the injected context.","cause":"Attempting to access `ssg.config` or `ssg.env` outside of the `export default` or `export const head` functions within a page file.","error":"Cannot read properties of undefined (reading 'config')` or `ssg is not defined"},{"fix":"Verify the relative import path (`../ssg/...`) matches the expected generated helper location based on your project structure and the schema name in your `graphql-ssg.json` file.","cause":"Incorrect import path for the generated `Chain` client, `html` helper, or `md` helper, or a GraphQL schema name mismatch in `graphql-ssg.json`.","error":"ReferenceError: Chain is not defined` or `Cannot find module '../ssg/{schema-name}/index.js"}],"ecosystem":"npm"}