create-ollie-shop 0.1.1

package/.turbo/turbo-build.log

@@ -0,0 +1,13 @@
+
+> create-ollie-shop@0.1.1 build /home/runner/work/ollie-shop/ollie-shop/packages/create-ollie-shop
+> tsup
+
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.0
+CLI Using tsup config: /home/runner/work/ollie-shop/ollie-shop/packages/create-ollie-shop/tsup.config.ts
+CLI Target: es2022
+CLI Cleaning output folder
+ESM Build start
+ESM dist/index.js 6.28 KB
+ESM ⚡️ Build success in 90ms

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# create-ollie-shop
+
+## 0.1.1
+
+### Patch Changes
+
+- b6c3baf: Initial release
+- Updated dependencies [b6c3baf]
+  - @ollie-shop/previewjs@0.1.1

package/README.md

@@ -0,0 +1,129 @@
+# create-ollie-shop
+
+A CLI tool to create a new Ollie Shop e-commerce project with a modern tech stack and pre-built components.
+
+## Overview
+
+`create-ollie-shop` is a scaffolding tool that helps you quickly set up a new e-commerce project using the Ollie Shop framework. It provides a selection of templates, components, and configurations to kickstart your online store development.
+
+## Requirements
+
+- Node.js 20.x or higher
+- pnpm 7.x or higher (recommended package manager)
+
+## Installation
+
+### Using pnpm create
+
+```bash
+pnpm create ollie-shop [project-name]
+```
+
+### Or use directly with npx
+
+```bash
+npx create-ollie-shop [project-name]
+```
+
+### Options
+
+- `--store-id <id>` - Specify an Ollie store ID
+- `--version-id <id>` - Specify an Ollie store version ID
+- `--help` - Display help information
+- `--version` - Display version information
+
+### Examples
+
+```bash
+# Start interactive project bootstrapping
+npx create-ollie-shop
+
+# Create a new project with a custom name
+npx create-ollie-shop my-awesome-store
+
+# Create a new project with store configuration
+npx create-ollie-shop my-store --store-id 7217542a-d7c6-40d3-a20e-db13b310a781 --version-id 882c8c18-550c-4ac5-9d3b-015d7dd25741
+```
+
+## Preview.js Plugin
+
+Ollie Shop projects were designed to be previewed using the Preview.js plugin for VS Code. This tool allows developers to visualize and interact with components in isolation during development.
+
+### Installation
+
+Simply install the Preview.js extension from the VS Code marketplace:
+[VS Code Extension](https://marketplace.visualstudio.com/items?itemName=zenclabs.previewjs)
+
+### Usage
+
+Preview.js works seamlessly with properly bootstrapped Ollie Shop projects. After creating your project with `create-ollie-shop`, the Preview.js server will automatically read the Ollie configurations and set up accordingly.
+
+To use Preview.js:
+1. Open any component file in your Ollie Shop project
+2. Click the Preview.js icon in the editor or press the keyboard shortcut
+3. A live preview of your component will appear, reflecting any changes you make in real-time
+
+This integration allows you to develop and test components without needing to set up a separate development environment or manually configure Preview.js.
+
+## Development
+
+To work on `create-ollie-shop` locally:
+
+1. Clone the repository
+
+```bash
+git clone git@github.com:ollie-shop/ollie-shop.git
+cd ollie-shop
+```
+
+2. Install dependencies
+
+```bash
+pnpm install
+```
+
+3. Link local packages
+
+```bash
+# Navigate to the create-ollie-shop package directory
+cd packages/create-ollie-shop
+
+# Create a global link
+pnpm link --global
+
+# For working with other local packages, use pnpm link inside each package directory
+# For example, to link the ollie-shop library:
+cd ../ollie-shop
+pnpm link --global
+
+# Then, in the create-ollie-shop directory:
+pnpm link --global ollie-shop
+```
+
+> **Note**: When using `pnpm link`, make sure all linked packages have their dependencies installed. The link creates a symlink to your local package, allowing you to make changes and immediately see them reflected in projects that use the linked package.
+
+4. Build the package
+
+```bash
+pnpm build
+```
+
+5. Test your changes
+
+```bash
+pnpm test
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,211 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import path2 from "path";
+import chalk3 from "chalk";
+import { Command } from "commander";
+import fs2 from "fs-extra";
+
+// src/commands/create-project.ts
+import child_process from "child_process";
+import path from "path";
+import { fileURLToPath } from "url";
+import { promisify } from "util";
+import chalk from "chalk";
+import fs from "fs-extra";
+var exec = promisify(child_process.exec);
+var BASE_DIR = path.dirname(fileURLToPath(import.meta.url));
+async function createProject(config) {
+  const {
+    projectName,
+    storeId,
+    versionId,
+    platform,
+    platformStoreId,
+    targetDir
+  } = config;
+  console.log(
+    `
+\u{1F680} Creating a new Ollie Shop project in ${chalk.green(`./${projectName}`)}...`
+  );
+  fs.ensureDirSync(targetDir);
+  const templateDir = path.join(BASE_DIR, "template");
+  await fs.copy(templateDir, targetDir, {
+    overwrite: true
+  });
+  const pkgPath = path.join(targetDir, "package.json");
+  const pkg = await fs.readJSON(path.join(targetDir, "package.json"));
+  pkg.name = projectName;
+  await fs.writeJSON(pkgPath, pkg, { spaces: 2 });
+  const ollieConfigPath = path.join(targetDir, "ollie.json");
+  await fs.writeJSON(
+    ollieConfigPath,
+    {
+      storeId: storeId || null,
+      versionId: versionId || null,
+      platform,
+      platformStoreId: platformStoreId || null
+    },
+    { spaces: 2 }
+  );
+  try {
+    await exec("git init", { cwd: targetDir });
+  } catch (e) {
+    console.log("\n\u274C Error initializing git:", e);
+  }
+  printSuccessMessage(
+    projectName,
+    storeId,
+    versionId,
+    platform,
+    platformStoreId
+  );
+}
+function printSuccessMessage(projectName, storeId, versionId, platform, platformStoreId) {
+  console.log("\n\u2705 Project created successfully!");
+  console.log("\nNext steps:");
+  console.log(`  cd ${chalk.cyan(projectName)}`);
+  console.log(
+    `  npm install (or ${chalk.cyan("pnpm install")} or ${chalk.cyan("yarn")})`
+  );
+  console.log(
+    "\n  The development environment leverages the Preview.js extension for VS Code:"
+  );
+  console.log(
+    `  ${chalk.cyan("https://marketplace.visualstudio.com/items?itemName=zenclabs.previewjs")}
+`
+  );
+  if (storeId) {
+    console.log(`Store ID: ${chalk.green(storeId)}`);
+  } else if (platform && platformStoreId) {
+    console.log(`Platform: ${chalk.green(platform)}`);
+    console.log(`Platform Store ID: ${chalk.green(platformStoreId)}`);
+  }
+  if (versionId) {
+    console.log(`Version ID: ${chalk.green(versionId)}`);
+  }
+  console.log("\n\u{1F6CD}\uFE0F  Happy development with Ollie Shop! \u{1F6CD}\uFE0F\n");
+}
+
+// src/utils/prompts.ts
+import chalk2 from "chalk";
+import prompts from "prompts";
+import { z } from "zod";
+async function promptForProjectName(defaultValue = "my-ollie-shop") {
+  const { value } = await prompts({
+    type: "text",
+    name: "value",
+    message: "Project name:",
+    initial: defaultValue,
+    validate: (value2) => z.string().nonempty().safeParse(value2).success
+  });
+  return value || defaultValue;
+}
+async function promptForOverwrite(dirName) {
+  const { overwrite } = await prompts({
+    type: "confirm",
+    name: "overwrite",
+    message: `Directory ${chalk2.cyan(dirName)} already exists. Overwrite?`,
+    initial: false
+  });
+  return overwrite;
+}
+async function promptForStoreId() {
+  const { value } = await prompts({
+    type: "text",
+    name: "value",
+    message: "Store ID (optional):",
+    hint: "Leave empty if you want to set up the workspace manually",
+    validate: (value2) => z.string().uuid().or(z.literal("")).safeParse(value2).success || "Please enter a valid UUID or leave empty"
+  });
+  return value && value.trim() !== "" ? value : void 0;
+}
+async function promptForPlatformStoreId(platform) {
+  const { platformStoreId } = await prompts({
+    type: "text",
+    name: "platformStoreId",
+    message: `Enter your ${platform.toUpperCase()} account name:`,
+    validate: (value) => z.string().min(1).safeParse(value).success || "Account name cannot be empty"
+  });
+  return platformStoreId;
+}
+async function promptForVersionId() {
+  const { value } = await prompts({
+    type: "text",
+    name: "value",
+    message: "Version ID (optional):",
+    validate: (value2) => z.string().uuid().or(z.literal("")).safeParse(value2).success
+  });
+  return value && value.trim() !== "" ? value : void 0;
+}
+
+// src/index.ts
+async function main() {
+  console.log(
+    chalk3.bold.blue(
+      "\u{1F6CD}\uFE0F  Create Ollie Shop - Bootstrap a new Ollie Shop project"
+    )
+  );
+  const program = new Command().name("create-ollie-shop").description(
+    "Bootstrap a new Ollie Shop project with optional store configuration"
+  ).version("0.1.0").argument("[project-name]", "Project folder name", "my-ollie-shop").option("--store-id <id>", "Specify an Ollie store ID").option("--version-id <id>", "Specify an Ollie store version ID").addHelpText(
+    "after",
+    `
+  Examples:
+    $ create-ollie-shop
+    $ create-ollie-shop my-awesome-store
+    $ create-ollie-shop my-store --store-id 7217542a-d7c6-40d3-a20e-db13b310a781 --version-id 882c8c18-550c-4ac5-9d3b-015d7dd25741
+  `
+  ).parse(process.argv);
+  try {
+    await initializeProject(program);
+  } catch (error) {
+    console.error(chalk3.red("\n\u274C Error:"), error);
+    process.exit(1);
+  }
+}
+async function initializeProject(program) {
+  const options = program.opts();
+  let storeId = options.storeId;
+  let versionId = options.versionId;
+  const platform = "vtex";
+  let platformStoreId;
+  let projectName = program.args[0];
+  if (!projectName) {
+    projectName = await promptForProjectName();
+  }
+  const cwd = process.cwd();
+  const targetDir = path2.join(cwd, projectName);
+  if (fs2.existsSync(targetDir)) {
+    const shouldOverwrite = await promptForOverwrite(projectName);
+    if (!shouldOverwrite) {
+      console.log(chalk3.red("\u274C Operation cancelled"));
+      return;
+    }
+    await fs2.emptyDir(targetDir);
+  }
+  if (!storeId) {
+    storeId = await promptForStoreId();
+    if (!storeId) {
+      console.log(
+        chalk3.blue(
+          `Using ${chalk3.bold(platform.toUpperCase())} as the platform`
+        )
+      );
+      platformStoreId = await promptForPlatformStoreId(platform);
+    }
+  }
+  if (!versionId) {
+    versionId = await promptForVersionId();
+  }
+  const config = {
+    projectName,
+    storeId,
+    versionId,
+    platform,
+    platformStoreId,
+    targetDir
+  };
+  await createProject(config);
+}
+main();

package/dist/template/.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+  "recommendations": ["biomejs.biome", "zenclabs.previewjs"]
+}

package/dist/template/.vscode/settings.json

@@ -0,0 +1,26 @@
+{
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "biomejs.biome",
+  "editor.codeActionsOnSave": {
+    "source.fixAll.biome": "explicit",
+    "source.organizeImports.biome": "explicit"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[javascriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  }
+}

package/dist/template/components/HelloWorld/index.tsx

@@ -0,0 +1,10 @@
+import styles from "./styles.module.css";
+
+export default function HelloWorld({ name = "Stranger" }: { name?: string }) {
+  return (
+    <div className={styles.container}>
+      <h1>Hello, {name}!</h1>
+      <p>Test</p>
+    </div>
+  );
+}

package/dist/template/components/HelloWorld/styles.module.css

@@ -0,0 +1,7 @@
+.container {
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  flex-direction: column;
+  gap: 1rem;
+}

package/dist/template/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "dev",
+  "version": "0.1.0",
+  "private": true,
+  "devDependencies": {
+    "@ollie-shop/sdk": "^0.1.0",
+    "@ollie-shop/previewjs": "^0.1.0",
+    "@types/node": "^22.14.0",
+    "@types/react": "^19.1.0",
+    "@types/react-dom": "^19.1.1",
+    "next": "^15.3.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.7.3",
+    "vite": "^6.2.5"
+  }
+}

package/dist/template/preview.config.ts

@@ -0,0 +1,3 @@
+import { defineConfig } from "@ollie-shop/previewjs";
+
+export default defineConfig();

package/dist/template/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "lib": ["ES2022"],
+    "module": "ES2022",
+    "target": "ES2022",
+    "moduleResolution": "Bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "declaration": true,
+    "noUncheckedIndexedAccess": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "typeRoots": ["./node_modules/@types", "./types"],
+    "types": ["node"]
+  },
+  "exclude": ["node_modules", "dist"]
+}

package/dist/template/types/index.d.ts

@@ -0,0 +1,4 @@
+declare module "*.css" {
+  const classes: { readonly [key: string]: string };
+  export default classes;
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "create-ollie-shop",
+  "version": "0.1.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "create-ollie-shop": "./dist/index.js"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.14.0",
+    "@types/prompts": "^2.4.9",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.4"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^11.1.0",
+    "fs-extra": "^11.3.0",
+    "prompts": "^2.4.2",
+    "zod": "^3.24.2",
+    "@ollie-shop/previewjs": "^0.1.1"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest"
+  }
+}

package/src/commands/create-project.ts

@@ -0,0 +1,114 @@
+import child_process from "node:child_process";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { promisify } from "node:util";
+import chalk from "chalk";
+import fs from "fs-extra";
+import type { OllieShopConfig } from "../types";
+
+const exec = promisify(child_process.exec);
+
+const BASE_DIR = path.dirname(fileURLToPath(import.meta.url));
+/**
+ * Create a new Ollie Shop project
+ */
+export async function createProject(config: OllieShopConfig): Promise<void> {
+  const {
+    projectName,
+    storeId,
+    versionId,
+    platform,
+    platformStoreId,
+    targetDir,
+  } = config;
+
+  console.log(
+    `\n🚀 Creating a new Ollie Shop project in ${chalk.green(`./${projectName}`)}...`,
+  );
+
+  // Ensure target directory exists
+  fs.ensureDirSync(targetDir);
+
+  // Get template directory path
+  const templateDir = path.join(BASE_DIR, "template");
+
+  // Copy template files to target directory
+  await fs.copy(templateDir, targetDir, {
+    overwrite: true,
+  });
+
+  // Update package.json with project name
+  const pkgPath = path.join(targetDir, "package.json");
+  const pkg = await fs.readJSON(path.join(targetDir, "package.json"));
+  pkg.name = projectName;
+  await fs.writeJSON(pkgPath, pkg, { spaces: 2 });
+
+  // Update ollie.json with config values
+  const ollieConfigPath = path.join(targetDir, "ollie.json");
+
+  await fs.writeJSON(
+    ollieConfigPath,
+    {
+      storeId: storeId || null,
+      versionId: versionId || null,
+      platform,
+      platformStoreId: platformStoreId || null,
+    },
+    { spaces: 2 },
+  );
+
+  // Initialize git in the folder
+  try {
+    await exec("git init", { cwd: targetDir });
+  } catch (e) {
+    console.log("\n❌ Error initializing git:", e);
+  }
+
+  // Print success message and next steps
+  printSuccessMessage(
+    projectName,
+    storeId,
+    versionId,
+    platform,
+    platformStoreId,
+  );
+}
+
+/**
+ * Print success message with next steps
+ */
+function printSuccessMessage(
+  projectName: string,
+  storeId?: string,
+  versionId?: string,
+  platform?: string,
+  platformStoreId?: string,
+): void {
+  console.log("\n✅ Project created successfully!");
+  console.log("\nNext steps:");
+  console.log(`  cd ${chalk.cyan(projectName)}`);
+  console.log(
+    `  npm install (or ${chalk.cyan("pnpm install")} or ${chalk.cyan("yarn")})`,
+  );
+
+  console.log(
+    "\n  The development environment leverages the Preview.js extension for VS Code:",
+  );
+  console.log(
+    `  ${chalk.cyan("https://marketplace.visualstudio.com/items?itemName=zenclabs.previewjs")}\n`,
+  );
+
+  // Display configuration information
+  if (storeId) {
+    console.log(`Store ID: ${chalk.green(storeId)}`);
+  } else if (platform && platformStoreId) {
+    console.log(`Platform: ${chalk.green(platform)}`);
+    console.log(`Platform Store ID: ${chalk.green(platformStoreId)}`);
+  }
+
+  if (versionId) {
+    console.log(`Version ID: ${chalk.green(versionId)}`);
+  }
+
+  console.log("\n🛍️  Happy development with Ollie Shop! 🛍️\n");
+}

package/src/index.ts

@@ -0,0 +1,130 @@
+import path from "node:path";
+import chalk from "chalk";
+import { Command } from "commander";
+import fs from "fs-extra";
+
+import { createProject } from "./commands/create-project";
+import type { OllieShopConfig } from "./types";
+import {
+  promptForOverwrite,
+  promptForPlatformStoreId,
+  promptForProjectName,
+  promptForStoreId,
+  promptForVersionId,
+} from "./utils/prompts";
+
+/**
+ * Main CLI entry point
+ */
+async function main(): Promise<void> {
+  console.log(
+    chalk.bold.blue(
+      "🛍️  Create Ollie Shop - Bootstrap a new Ollie Shop project",
+    ),
+  );
+
+  // Set up Commander for argument parsing
+  const program = new Command()
+    .name("create-ollie-shop")
+    .description(
+      "Bootstrap a new Ollie Shop project with optional store configuration",
+    )
+    .version("0.1.0")
+    .argument("[project-name]", "Project folder name", "my-ollie-shop")
+    .option("--store-id <id>", "Specify an Ollie store ID")
+    .option("--version-id <id>", "Specify an Ollie store version ID")
+    .addHelpText(
+      "after",
+      `
+  Examples:
+    $ create-ollie-shop
+    $ create-ollie-shop my-awesome-store
+    $ create-ollie-shop my-store --store-id 7217542a-d7c6-40d3-a20e-db13b310a781 --version-id 882c8c18-550c-4ac5-9d3b-015d7dd25741
+  `,
+    )
+    .parse(process.argv);
+
+  try {
+    await initializeProject(program);
+  } catch (error) {
+    console.error(chalk.red("\n❌ Error:"), error);
+    process.exit(1);
+  }
+}
+
+/**
+ * Process command line arguments and initialize the project
+ */
+async function initializeProject(program: Command): Promise<void> {
+  // Get options from Commander
+  const options = program.opts();
+
+  // Extract CLI options
+  let storeId = options.storeId as string | undefined;
+  let versionId = options.versionId as string | undefined;
+
+  // For platform, we only support VTEX currently
+  const platform = "vtex";
+  let platformStoreId: string | undefined;
+
+  // Get or prompt for project name
+  let projectName = program.args[0];
+  if (!projectName) {
+    projectName = await promptForProjectName();
+  }
+
+  // Handle target directory
+  const cwd = process.cwd();
+  const targetDir = path.join(cwd, projectName);
+
+  // Check if target directory exists and confirm overwrite
+  if (fs.existsSync(targetDir)) {
+    const shouldOverwrite = await promptForOverwrite(projectName);
+
+    if (!shouldOverwrite) {
+      console.log(chalk.red("❌ Operation cancelled"));
+      return;
+    }
+
+    // Clean existing directory
+    await fs.emptyDir(targetDir);
+  }
+
+  // Handle store identification
+  if (!storeId) {
+    // First ask for a direct store ID
+    storeId = await promptForStoreId();
+
+    // If no store ID is provided, get platform store ID
+    if (!storeId) {
+      console.log(
+        chalk.blue(
+          `Using ${chalk.bold(platform.toUpperCase())} as the platform`,
+        ),
+      );
+
+      platformStoreId = await promptForPlatformStoreId(platform);
+    }
+  }
+
+  // Get version ID if not provided
+  if (!versionId) {
+    versionId = await promptForVersionId();
+  }
+
+  // Create configuration object
+  const config: OllieShopConfig = {
+    projectName,
+    storeId,
+    versionId,
+    platform,
+    platformStoreId,
+    targetDir,
+  };
+
+  // Create the project
+  await createProject(config);
+}
+
+// Start the CLI
+main();

package/src/types/index.ts

@@ -0,0 +1,17 @@
+/**
+ * Configuration options for creating a new Ollie Shop project
+ */
+export type OllieShopConfig = {
+  /** The name of the project */
+  projectName: string;
+  /** Optional Ollie store ID */
+  storeId?: string;
+  /** Optional version ID */
+  versionId?: string;
+  /** E-commerce platform (e.g., "vtex") */
+  platform?: string;
+  /** Store/Account ID from the platform */
+  platformStoreId?: string;
+  /** Target directory path */
+  targetDir: string;
+};

package/src/utils/prompts.ts

@@ -0,0 +1,85 @@
+import chalk from "chalk";
+import prompts from "prompts";
+import { z } from "zod";
+
+/**
+ * Prompt for project name
+ */
+export async function promptForProjectName(
+  defaultValue = "my-ollie-shop",
+): Promise<string> {
+  const { value } = await prompts({
+    type: "text",
+    name: "value",
+    message: "Project name:",
+    initial: defaultValue,
+    validate: (value) => z.string().nonempty().safeParse(value).success,
+  });
+
+  return value || defaultValue;
+}
+
+/**
+ * Prompt for directory overwrite confirmation
+ */
+export async function promptForOverwrite(dirName: string): Promise<boolean> {
+  const { overwrite } = await prompts({
+    type: "confirm",
+    name: "overwrite",
+    message: `Directory ${chalk.cyan(dirName)} already exists. Overwrite?`,
+    initial: false,
+  });
+
+  return overwrite;
+}
+
+/**
+ * Prompt for store ID
+ */
+export async function promptForStoreId(): Promise<string | undefined> {
+  const { value } = await prompts({
+    type: "text",
+    name: "value",
+    message: "Store ID (optional):",
+    hint: "Leave empty if you want to set up the workspace manually",
+    validate: (value) =>
+      z.string().uuid().or(z.literal("")).safeParse(value).success ||
+      "Please enter a valid UUID or leave empty",
+  });
+
+  // Return undefined if empty string
+  return value && value.trim() !== "" ? value : undefined;
+}
+
+/**
+ * Prompt for platform store ID
+ */
+export async function promptForPlatformStoreId(
+  platform: string,
+): Promise<string> {
+  const { platformStoreId } = await prompts({
+    type: "text",
+    name: "platformStoreId",
+    message: `Enter your ${platform.toUpperCase()} account name:`,
+    validate: (value) =>
+      z.string().min(1).safeParse(value).success ||
+      "Account name cannot be empty",
+  });
+
+  return platformStoreId;
+}
+
+/**
+ * Prompt for version ID
+ */
+export async function promptForVersionId(): Promise<string | undefined> {
+  const { value } = await prompts({
+    type: "text",
+    name: "value",
+    message: "Version ID (optional):",
+    validate: (value) =>
+      z.string().uuid().or(z.literal("")).safeParse(value).success,
+  });
+
+  return value && value.trim() !== "" ? value : undefined;
+}

package/template/.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+  "recommendations": ["biomejs.biome", "zenclabs.previewjs"]
+}

package/template/.vscode/settings.json

@@ -0,0 +1,26 @@
+{
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "biomejs.biome",
+  "editor.codeActionsOnSave": {
+    "source.fixAll.biome": "explicit",
+    "source.organizeImports.biome": "explicit"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[javascriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  }
+}

package/template/components/HelloWorld/index.tsx

@@ -0,0 +1,10 @@
+import styles from "./styles.module.css";
+
+export default function HelloWorld({ name = "Stranger" }: { name?: string }) {
+  return (
+    <div className={styles.container}>
+      <h1>Hello, {name}!</h1>
+      <p>Test</p>
+    </div>
+  );
+}

package/template/components/HelloWorld/meta.json

@@ -0,0 +1,6 @@
+{
+  "id": null,
+  "name": "Hello",
+  "props": null,
+  "src": "components/hello"
+}

package/template/components/HelloWorld/styles.module.css

@@ -0,0 +1,7 @@
+.container {
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  flex-direction: column;
+  gap: 1rem;
+}

package/template/ollie.json

@@ -0,0 +1,9 @@
+{
+  "storeId": null,
+  "versionId": null,
+  "platform": "vtex",
+  "platformStoreId": null,
+  "sessionId": "8be5691a4398411c875762eefc94b57c",
+  "props": null,
+  "theme": {}
+}

package/template/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "dev",
+  "version": "0.1.0",
+  "private": true,
+  "devDependencies": {
+    "@ollie-shop/sdk": "^0.1.0",
+    "@ollie-shop/previewjs": "^0.1.0",
+    "@types/node": "^22.14.0",
+    "@types/react": "^19.1.0",
+    "@types/react-dom": "^19.1.1",
+    "next": "^15.3.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.7.3",
+    "vite": "^6.2.5"
+  }
+}

package/template/preview.config.ts

@@ -0,0 +1,3 @@
+import { defineConfig } from "@ollie-shop/previewjs";
+
+export default defineConfig();

package/template/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "lib": ["ES2022"],
+    "module": "ES2022",
+    "target": "ES2022",
+    "moduleResolution": "Bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "declaration": true,
+    "noUncheckedIndexedAccess": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "typeRoots": ["./node_modules/@types", "./types"],
+    "types": ["node"]
+  },
+  "exclude": ["node_modules", "dist"]
+}

package/template/types/index.d.ts

@@ -0,0 +1,4 @@
+declare module "*.css" {
+  const classes: { readonly [key: string]: string };
+  export default classes;
+}

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "lib": ["ES2022"],
+    "module": "ES2022",
+    "target": "ES2022",
+    "moduleResolution": "Bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "declaration": true,
+    "noUncheckedIndexedAccess": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "composite": true,
+    "resolveJsonModule": true,
+    "types": ["node", "vitest/globals"],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "exclude": ["node_modules", "dist"]
+}

package/tsup.config.ts

@@ -0,0 +1,43 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { defineConfig } from "tsup";
+
+const EXCLUDED = [
+  // Node files
+  "node_modules",
+  "dist",
+  // Config files
+  "ollie.json",
+  "meta.json",
+  // Lock files
+  "pnpm-lock.yaml",
+  "package-lock.json",
+  "yarn.lock",
+];
+
+const REGEX_EXCLUDED = new RegExp(EXCLUDED.join("|"));
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: "esm",
+  sourcemap: false,
+  bundle: true,
+  clean: true,
+  banner: {
+    js: "#!/usr/bin/env node",
+  },
+  plugins: [
+    {
+      name: "copy-template",
+      buildEnd: async () => {
+        const templateDir = path.resolve("template");
+        const destDir = path.resolve("dist/template");
+
+        await fs.cp(templateDir, destDir, {
+          recursive: true,
+          filter: (src: string) => !REGEX_EXCLUDED.test(path.basename(src)),
+        });
+      },
+    },
+  ],
+});

package/vitest.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    globals: true,
+  },
+});