@red-glare/create 0.0.1

package/README.md

@@ -0,0 +1,29 @@
+# @red-glare/create
+
+> CLI scaffolder for [Red Glare](https://github.com/red-glare/red-glare) USWDS documentation sites.
+
+Bootstraps a new Astro project pre-wired with `@red-glare/astro`, USWDS styles, Preact for interactive islands, and a minimal docs starter.
+
+## Usage
+
+```bash
+pnpm create @red-glare my-agency-docs
+# or
+npm create @red-glare my-agency-docs
+# or
+yarn create @red-glare my-agency-docs
+```
+
+Then:
+
+```bash
+cd my-agency-docs
+pnpm install
+pnpm dev
+```
+
+See the [main README](https://github.com/red-glare/red-glare#readme) for what `@red-glare/astro` ships and how to configure it.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import process from 'node:process';
+import { parseArgs } from 'node:util';
+async function main() {
+    const { positionals } = parseArgs({ allowPositionals: true });
+    const projectName = positionals[0];
+    if (!projectName) {
+        // eslint-disable-next-line no-console
+        console.log('Usage: pnpm create @red-glare <project-name>\n\nExample:\n  pnpm create @red-glare my-agency-docs');
+        process.exit(1);
+    }
+    const projectDir = resolve(process.cwd(), projectName);
+    // eslint-disable-next-line no-console
+    console.log(`\nCreating Red Glare project in ${projectDir}...\n`);
+    await mkdir(join(projectDir, 'src/content/docs'), { recursive: true });
+    await mkdir(join(projectDir, 'src/styles'), { recursive: true });
+    await mkdir(join(projectDir, 'public'), { recursive: true });
+    // `@astrojs/preact` + `preact` ship alongside `@red-glare/astro`
+    // because Astro's renderer resolver looks up the integration's server
+    // entry point from the project cwd, not from the transitive dep
+    // graph. Omitting them here would leave a scaffolded project unable
+    // to hydrate its tab / code-group islands.
+    await writeFile(join(projectDir, 'package.json'), `${JSON.stringify({
+        name: projectName,
+        version: '0.0.1',
+        private: true,
+        type: 'module',
+        scripts: {
+            dev: 'astro dev',
+            build: 'astro build',
+            preview: 'astro preview',
+        },
+        dependencies: {
+            '@astrojs/preact': '^5.1.1',
+            '@red-glare/astro': '^0.0.1',
+            'astro': '^6.0.0',
+            'preact': '^10.29.1',
+        },
+    }, null, 2)}\n`);
+    await writeFile(join(projectDir, 'astro.config.mjs'), `import { defineConfig } from 'astro/config'
+import redGlare from '@red-glare/astro'
+
+export default defineConfig({
+  integrations: [
+    redGlare({
+      title: '${projectName}',
+      description: 'Documentation site powered by Red Glare',
+      governmentBanner: true,
+    }),
+  ],
+})
+`);
+    await writeFile(join(projectDir, 'src/content.config.ts'), `import { defineCollection } from 'astro:content'
+import { docsLoader, docsSchema } from '@red-glare/astro/schema'
+
+const docs = defineCollection({
+  loader: docsLoader(),
+  schema: docsSchema,
+})
+
+export const collections = { docs }
+`);
+    await writeFile(join(projectDir, 'src/content/docs/index.md'), `---
+title: Welcome
+description: Getting started with your documentation site.
+template: splash
+---
+
+Welcome to your new documentation site, powered by [Red Glare](https://github.com/red-glare).
+
+## Getting Started
+
+Edit this file at \`src/content/docs/index.md\` to get started.
+
+Add new pages by creating markdown files in \`src/content/docs/\`.
+`);
+    await writeFile(join(projectDir, 'src/content/docs/getting-started.md'), `---
+title: Getting Started
+description: How to set up and use this documentation site.
+sidebar:
+  order: 1
+---
+
+## Installation
+
+Your documentation site is already set up and ready to go.
+
+## Adding Pages
+
+Create new \`.md\` files in \`src/content/docs/\` and they will automatically appear in the sidebar.
+
+## Frontmatter
+
+Each page supports frontmatter for metadata:
+
+\`\`\`yaml
+---
+title: Page Title
+description: Brief description
+sidebar:
+  label: Custom Label
+  order: 1
+toc: true
+---
+\`\`\`
+`);
+    await writeFile(join(projectDir, 'tsconfig.json'), `${JSON.stringify({
+        extends: 'astro/tsconfigs/strict',
+        compilerOptions: {
+            types: ['node'],
+        },
+    }, null, 2)}\n`);
+    // eslint-disable-next-line no-console
+    console.log(`Done! Next steps:\n\n  cd ${projectName}\n  pnpm install\n  pnpm dev\n`);
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@red-glare/create",
+  "type": "module",
+  "version": "0.0.1",
+  "description": "CLI scaffolder for Red Glare documentation sites",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/red-glare/red-glare",
+    "directory": "packages/create"
+  },
+  "keywords": [
+    "create",
+    "scaffold",
+    "uswds",
+    "astro",
+    "documentation",
+    "federal",
+    "government"
+  ],
+  "bin": {
+    "red-glare": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}