sv-arcgis 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Joe Allen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,22 @@
+## 🗜️ Setup
+
+1. Install SvelteKit `npx sv create [project_name]`.
+2. Install sv-arcgis `npx sv-arcgis`.
+3. ⚠️ Follow instructions in terminal. ⚠️️
+
+## 📕 Notes
+
+- Using this will install @arcgis/core@4.31.6. (Testing has not been done on later releases)
+- If you choose 'Yes' to Map components, @arcgis/map-components@4.31.6 will be installed. (Testing has not been done on later releases).
+- If you choose 'Yes' to Calcite, @esri/calcite-components@2.13.0 will be installed. (Testing has not been done on later releases).
+
+## 🗺️ Roadmap
+
+- Option for / intergrate OAuth2 https://developers.arcgis.com/documentation/security-and-authentication/user-authentication/arcgis-apis/
+- Create tests (see https://www.youtube.com/watch?v=Xk8yaN9_PZA)
+- Create CI / CD (w/ tests)
+
+## 🙏 Help
+
+- ArcGIS / Calcite Issues?: Check new releases https://developers.arcgis.com/calcite-design-system/releases (see Compatibility section for each release)
+- PRs, Issues, etc. are always welcome.

package/bin/sv-arcgis-setup.js

@@ -0,0 +1,738 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+
+const packageJsonPath = path.join(process.cwd(), 'package.json');
+
+if (!fs.existsSync(packageJsonPath)) {
+  console.error('No package.json found in current directory');
+  process.exit(1);
+}
+
+const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+
+// Detect package manager
+const hasPnpmLock = fs.existsSync(path.join(process.cwd(), 'pnpm-lock.yaml'));
+const hasYarnLock = fs.existsSync(path.join(process.cwd(), 'yarn.lock'));
+
+let packageManager = 'npm';
+if (hasPnpmLock) {
+  packageManager = 'pnpm';
+} else if (hasYarnLock) {
+  packageManager = 'yarn';
+}
+
+// Create config directory
+const configDirectory = path.join(process.cwd(), '.config');
+if (!fs.existsSync(configDirectory)) {
+  fs.mkdirSync(configDirectory, { recursive: true });
+  // console.log("✅ Created .config directory");
+}
+
+// Create init-sv-arcgis.js file
+const initConfigPath = path.join(configDirectory, 'init-sv-arcgis.js');
+const initConfigContent = `#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+import prompts from 'prompts';
+import chalk from 'chalk';
+
+import { exec } from 'node:child_process';
+
+const packageJsonContent = fs.readFileSync(path.join(process.cwd(), './package.json'), 'utf8');
+const usesTypeScript = fs.existsSync(path.join(process.cwd(), 'tsconfig.json'));
+const packageInfo = JSON.parse(packageJsonContent);
+const version = packageInfo.version;
+let configPath;
+let envPath;
+let envExamplePath;
+
+
+// Write to ./src/lib/config/index.js
+// Prompts user for:
+// PORTAL_URL
+// WEBMAP_ID
+// APP_ID
+// BASE
+// APP_NAME
+// SECURITY_CLASSIFICATION
+// MAP_COMPONENTS
+// CALCITE
+// API_KEY
+// CLIENT_ID
+// CLIENT_SECRET
+
+// Respect terminating the process (ctrl+c)
+const onCancel = () => {
+  console.log("🛑 Setup canceled. Exiting...");
+  process.exit(0);
+};
+
+async function generateConfig() {
+
+  // Check if SvelteKit is installed
+  const isSvelteKit = fs.existsSync(path.join(process.cwd(), 'src/routes/+page.svelte'));
+  if (!isSvelteKit) {
+    console.log("🛑 This doesn\'t seem like a SvelteKit project.");
+    console.log("🛑 Have you ran 'npx sv create ./' yet?");
+    process.exit(1);
+  }
+
+// const environment = await prompts([
+//   {
+//     type: 'select',
+//     name: 'ENVIRONMENT',
+//     message: 'What environment do you want to setup?',
+//     choices: [
+//       { title: 'development', value: 'development' },
+//       { title: 'staging', value: 'staging' },
+//       { title: 'production', value: 'production' },
+//     ],
+//     validate: value => {
+//       global.environment = value;
+//       return true;
+//     }
+//   }
+// ], { onCancel });
+// console.log("");
+
+// Set env
+// global.env = environment.ENVIRONMENT;
+
+// Check if env specific config file already exists
+configPath = path.join(process.cwd(), usesTypeScript ? './src/lib/config/index.ts' : './src/lib/config/index.js');
+envPath = path.join(process.cwd(), \`.env\`);
+envExamplePath = path.join(process.cwd(), \`.env.example\`);
+
+// Warn if exists
+if (fs.existsSync(configPath) || fs.existsSync(envPath)) {
+
+  console.log("⚠️  Warning");
+  console.log("");
+
+  const { overwrite } = await prompts({
+    type: 'confirm',
+    name: 'overwrite',
+    message: 'Config and / or .env file already exist. Overwrite?',
+    initial: false
+  });
+
+  // Show cancelled msg
+  if (!overwrite) {
+    console.log("Setup canceled. Existing configuration preserved.");
+    return;
+  }
+}
+
+// Start config!
+console.log("");
+console.log("👋 Hello");
+console.log("");
+
+// Use package.json version, else...
+const VERSION = { version } ? version : '0.1.0';
+
+const appName = await prompts([
+  {
+    type: 'text',
+    name: 'APP_NAME',
+    message: 'Enter your appName',
+    validate: value => {
+      global.appNameIsNull = value.length === 0;
+      return true;
+    }
+  }
+], { onCancel });
+console.log("");
+
+const base = await prompts([
+  {
+    type: 'text',
+    name: 'BASE',
+    message: 'Enter your baseUrl (e.g. /)',
+    validate: value => {
+      global.baseIsNull = value.length === 0;
+      return true;
+    },
+    format: value => value.startsWith('/') ? value : \`/\${value}\`
+  },
+  {
+    type: () => global.baseIsNull ? 'text' : null,
+    name: 'BASE',
+    message: 'BASE_URL is required. It will default to "/"',
+    initial: '/',
+    format: value => value.startsWith('/') ? value : \`/\${value}\`
+  }
+], { onCancel });
+console.log("");
+
+const portalUrl = await prompts([
+  {
+    type: 'text',
+    name: 'PORTAL_URL',
+    message: 'Enter your Portal URL',
+    validate: value => {
+      global.portalUrlIsNull = value.length === 0;
+      return true;
+    }
+  },
+  {
+    // type: () => global.portalUrlIsNull ? 'text' : null,
+    // name: 'PORTAL_URL',
+    // message: 'portalUrl is required. If proceeding it\'ll be set to: ',
+    // initial: 'https://prof-services.maps.arcgis.com/',
+  }
+], { onCancel });
+console.log("");
+
+const webmapId = await prompts([
+  {
+    type: 'text',
+    name: 'WEBMAP_ID',
+    message: 'Enter your webmapId',
+    validate: value => {
+      global.webmapIdIsNull = value.length === 0;
+      return true;
+    }
+  }
+], { onCancel });
+console.log("");
+
+const appId = await prompts([
+  {
+    type: 'text',
+    name: 'APP_ID',
+    message: 'Enter your appId',
+    validate: value => {
+      global.appIdIsNull = value.length === 0;
+      return true;
+    }
+  }
+], { onCancel });
+console.log("");
+
+const arcGisApiKey = await prompts([
+  {
+    type: 'text',
+    name: 'ARC_GIS_API_KEY',
+    message: 'Enter your ArcGIS API key (optional)',
+    validate: value => {
+      global.arcGisApiKeyIsNull = value.length === 0;
+      return true;
+    }
+  }
+], { onCancel });
+console.log("");
+
+const arcGisClientId = await prompts([
+  {
+    type: 'text',
+    name: 'ARC_GIS_CLIENT_ID',
+    message: 'Enter your ArcGIS Client ID (optional)',
+    validate: value => {
+      global.arcGisClientIdIsNull = value.length === 0;
+      return true;
+    }
+  }
+], { onCancel });
+console.log("");
+
+const arcGisClientSecret = await prompts([
+  {
+    type: 'text',
+    name: 'ARC_GIS_CLIENT_SECRET',
+    message: 'Enter your ArcGIS Client Secret (optional)',
+    validate: value => {
+      global.arcGisClientSecretIsNull = value.length === 0;
+      return true;
+    }
+  }
+], { onCancel });
+console.log("");
+
+const securityClassification = await prompts([
+  {
+    type: 'select',
+    name: 'SECURITY_CLASSIFICATION',
+    message: 'Do you need the Security Classification bars above and below on the UI?',
+    choices: [
+      { title: 'None', value: false },
+      { title: 'Classified', value: 'classified' },
+      { title: 'Confidential', value: 'confidential' },
+      { title: 'Controlled Unclassified Information', value: 'controlled_unclassified_information' },
+      { title: 'Secret', value: 'secret' },
+      { title: 'Top Secret', value: 'top_secret' },
+      { title: 'Top Secret Sensitive Compartment Information', value: 'top_secret_sensitive_compartment_information' },
+      { title: 'Unclassified', value: 'unclassified' }
+    ],
+    validate: value => {
+      global.securityClassificationIsNull = value.length === 0;
+      return true;
+    }
+  },
+  {
+    type: () => global.securityClassificationIsNull ? 'text' : null,
+    name: 'SECURITY_CLASSIFICATION',
+    initial: false,
+  }
+], { onCancel });
+console.log("");
+
+const mapComponents = await prompts([
+  {
+    type: 'select',
+    name: 'MAP_COMPONENTS',
+    message: 'Do you want to use Map Components?',
+    choices: [
+      { title: 'Yes', value: true },
+      { title: 'No', value: false }
+    ],
+    validate: value => {
+      global.mapComponentsIsNull = value.length === 0;
+      return true;
+    }
+  }
+], { onCancel });
+console.log("");
+
+const calcite = await prompts([
+  {
+    type: 'select',
+    name: 'CALCITE',
+    message: 'Do you want to use Calcite Components?',
+    choices: [
+      { title: 'Yes', value: true },
+      { title: 'No', value: false }
+    ],
+    validate: value => {
+      global.calciteIsNull = value.length === 0;
+      return true;
+    }
+  }
+], { onCancel });
+console.log("");
+
+const demo = await prompts([
+  {
+    type: 'select',
+    name: 'DEMO',
+    message: 'Would you like a demo page?',
+    choices: [
+      { title: 'Yes', value: true },
+      { title: 'No', value: false }
+    ],
+    validate: value => {
+      global.demoIsNull = value.length === 0;
+      return true;
+    }
+  }
+], { onCancel });
+console.log("");
+
+// Detect package manager
+const hasPnpmLock = fs.existsSync(path.join(process.cwd(), 'pnpm-lock.yaml'));
+const hasYarnLock = fs.existsSync(path.join(process.cwd(), 'yarn.lock'));
+
+let packageManager = 'npm';
+if (hasPnpmLock) {
+  packageManager = 'pnpm';
+} else if (hasYarnLock) {
+  packageManager = 'yarn';
+}
+
+
+// Install packages with loader
+const initPromises = [];
+
+if (mapComponents.MAP_COMPONENTS === true && calcite.CALCITE === true) {
+  console.log("📦 Installing ArcGIS Core, Map Components, and Calcite Components...");
+  initPromises.push(
+    new Promise((resolve, reject) => {
+      exec(\`\${packageManager} install @arcgis/core@4.31.6 @arcgis/map-components@4.31.6 @esri/calcite-components@2.13.0\`, (error, stdout, stderr) => {
+        if (error) {
+          console.log('error:', chalk.white.bgRed(error.message));
+          reject(error);
+        } else {
+          resolve();
+        }
+      });
+    })
+  );
+} else {
+  // Install just mapComponents?
+  if (mapComponents.MAP_COMPONENTS === true) {
+    console.log("📦 Installing ArcGIS Core and Map Components...");
+    initPromises.push(
+      new Promise((resolve, reject) => {
+        exec(\`\${packageManager} install @arcgis/core@4.31.6 @arcgis/map-components@4.31.6\`, (error, stdout, stderr) => {
+          if (error) {
+            console.log('error:', chalk.white.bgRed(error.message));
+            reject(error);
+          } else {
+            resolve();
+          }
+        });
+      })
+    );
+  }
+    
+  // Install just Calcite?
+  if (calcite.CALCITE === true) {
+    console.log("📦 Installing Calcite Components...");
+    initPromises.push(
+      new Promise((resolve, reject) => {
+        exec(\`\${packageManager} install @esri/calcite-components@2.13.0\`, (error, stdout, stderr) => {
+          if (error) {
+            console.log('error:', chalk.white.bgRed(error.message));
+            reject(error);
+          } else {
+            resolve();
+          }
+        });
+      })
+    );
+  }
+}
+
+// Wait for all installations to complete
+if (initPromises.length > 0) {
+  try {
+    await Promise.all(initPromises);
+    console.log("");
+    console.log("✅ Package installation completed!");
+    } catch (error) {
+    console.log("");
+    console.log("❌ Package installation failed:", error.message);
+  }
+}
+
+// Add demo page?
+if (demo.DEMO === true) {
+  // Create directory called 'arcgis' in './src/routes/'
+  const arcgisRouteDir = path.join(process.cwd(), 'src', 'routes', 'arcgis');
+  if (!fs.existsSync(arcgisRouteDir)) {
+    fs.mkdirSync(arcgisRouteDir, { recursive: true });
+  }
+
+  // Create a demo page within this directory called '+page.svelte'
+  const demoPagePath = path.join(arcgisRouteDir, '+page.svelte');
+  
+  const demoPageContent = \`<script lang="ts">
+    // config
+    import config from "$lib/config";
+
+    // sk
+    import { onMount } from "svelte";
+    import { browser } from "$app/environment";
+    import { env } from "$env/dynamic/public";
+
+    // variables
+    let mapWrap: HTMLDivElement | null = $state(null);
+
+    onMount(() => {
+      console.log("env", env);
+      console.log("config", config);
+      console.log("mapWrap", mapWrap);
+    });
+
+    if (browser) {
+      import("@arcgis/map-components/dist/loader").then(
+        ({ defineCustomElements }) => {
+          defineCustomElements(window, {
+            resourcesUrl: "https://js.arcgis.com/map-components/4.31.6/assets",
+          });
+        }
+      );
+    }
+  </script>
+
+  <svelte:head>
+    <title>🗺️ SV + ArcGIS Demo</title>
+  </svelte:head>
+
+  <main class="e-demo">
+    {#if config.SECURITY_CLASSIFICATION}
+      <div
+        class="e-demo-security-bar e-demo-security-bar--{config.SECURITY_CLASSIFICATION}"
+      >
+        Security Classification: {config.SECURITY_CLASSIFICATION.toUpperCase()}
+      </div>
+    {/if}
+    <div class="e-demo-container">
+      <div class="e-demo-header">
+        <h1>🗺️ SV + ArcGIS Demo</h1>
+      </div>
+      <div class="e-demo-map-wrap" bind:this={mapWrap}>
+        <arcgis-map item-id="05e015c5f0314db9a487a9b46cb37eca">
+          <arcgis-zoom position="top-left"></arcgis-zoom>
+        </arcgis-map>
+        {#if config.CALCITE}
+          <calcite-button href="/" appearance="solid" scale="m">
+            Go Home
+          </calcite-button>
+        {/if}
+      </div>
+    </div>
+    {#if config.SECURITY_CLASSIFICATION}
+      <div
+        class="e-demo-security-bar e-demo-security-bar--{config.SECURITY_CLASSIFICATION}"
+      >
+        Security Classification: {config.SECURITY_CLASSIFICATION.toUpperCase()}
+      </div>
+    {/if}
+  </main>
+
+  <style>
+    @import "https://js.arcgis.com/4.31/@arcgis/core/assets/esri/themes/dark/main.css";
+    @import "@esri/calcite-components/dist/calcite/calcite.css";
+
+    :global(body:has(.e-demo)) {
+      margin: 0;
+      padding: 0;
+      height: 100%;
+      width: 100%;
+      background: #212121;
+    }
+
+    .e-demo {
+      display: grid;
+      grid-template-rows: 24px 1fr 24px;
+      height: 100vh;
+    }
+
+    .e-demo-container {
+      display: flex;
+      flex-direction: column;
+      align-items: center;
+    }
+
+    .e-demo-header {
+      padding: 1rem;
+      color: #f1f1f1;
+
+      translate: 0 0;
+      transition: translate 1s ease-out;
+
+      @starting-style {
+        translate: 0 -4px;
+      }
+    }
+
+    .e-demo-map-wrap {
+      display: flex;
+      flex-direction: column;
+      gap: 2rem;
+      width: 50vmax;
+      height: 100vh;
+      margin-inline: auto;
+      margin: 0;
+      padding: 0;
+      padding-block-end: 2rem;
+
+      & arcgis-map {
+        width: 100%;
+        height: 50vh;
+
+        opacity: 1;
+        transition: opacity 2s ease-out;
+
+        @starting-style {
+          opacity: 0;
+        }
+      }
+
+      & calcite-button {
+        align-self: center;
+      }
+    }
+
+    .e-demo-security-bar {
+      position: sticky;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      inset-block-start: 0;
+      height: 22px;
+      background-color: #000;
+      color: #fff;
+      margin: 0;
+      font-size: 14px;
+      z-index: 1;
+
+      &:not(:first-of-type) {
+        inset-block-end: 0;
+      }
+
+      &.e-demo-security-bar--classified {
+        color: #fff;
+        background-color: #723d9a;
+      }
+      &.e-demo-security-bar--confidential {
+        color: #fff;
+        background-color: #0033a0;
+      }
+      &.e-demo-security-bar--controlled_unclassified_information {
+        color: #fff;
+        background-color: #3d1e5a;
+      }
+      &.e-demo-security-bar--secret {
+        color: #fff;
+        background-color: #c8102e;
+      }
+      &.e-demo-security-bar--top_secret {
+        color: #000;
+        background-color: #ff671f;
+      }
+      &.e-demo-security-bar--top_secret_sensitive_compartment_information {
+        color: #000;
+        background-color: #f7ea48;
+      }
+      &.e-demo-security-bar--unclassified {
+        color: #fff;
+        background-color: #007a33;
+      }
+    }
+  </style>
+  \`;
+
+  fs.writeFileSync(demoPagePath, demoPageContent);
+  console.log(\`✅ Created demo page at ./src/routes/arcgis/+page.svelte\`);
+  
+  // Update root page with link to demo
+  const rootRouteDir = path.join(process.cwd(), 'src', 'routes');
+  const rootPagePath = path.join(rootRouteDir, '+page.svelte');
+  const rootPageUpdate = \`<p>Visit the <a href="arcgis">arcgis demo page</a> and view console.log output</p>\`;
+  
+  // Read existing root page content and append the demo link
+  if (fs.existsSync(rootPagePath)) {
+    const existingContent = fs.readFileSync(rootPagePath, 'utf8');
+    if (!existingContent.includes('arcgis demo page')) {
+      const updatedContent = existingContent + \`\n\` + rootPageUpdate;
+      fs.writeFileSync(rootPagePath, updatedContent);
+    }
+    console.log(\`✅ Updated homepage with demo link\`);
+  }
+}
+
+const config = {
+  VERSION,
+  ...appName,
+  ...base,
+  ...portalUrl,
+  ...webmapId,
+  ...appId,
+  ...securityClassification,
+  ...mapComponents,
+  ...calcite
+}
+
+const env = \`ARC_GIS_API_KEY=\${arcGisApiKey.ARC_GIS_API_KEY}
+ARC_GIS_CLIENT_SECRET=\${arcGisClientSecret.ARC_GIS_CLIENT_SECRET}
+PUBLIC_ARC_GIS_CLIENT_ID=\${arcGisClientId.ARC_GIS_CLIENT_ID}\`;
+
+const envExample = \`# ARC_GIS_API_KEY=
+# ARC_GIS_CLIENT_SECRET=
+# PUBLIC_ARC_GIS_CLIENT_ID=\`;
+
+// Ensure the config directory exists
+const configDir = path.join(process.cwd(), 'src', 'lib', 'config');
+if (!fs.existsSync(configDir)) {
+  fs.mkdirSync(configDir, { recursive: true });
+}
+
+// Create proper JavaScript module content
+const configContent = \`\${JSON.stringify(config, null, 2)}\`;
+const envContent = env;
+fs.writeFileSync(configPath, configContent);
+fs.writeFileSync(envPath, envContent);
+fs.writeFileSync(envExamplePath, envExample);
+
+return {
+  config,
+  env
+};
+}
+
+// Execute, log, handle errors
+generateConfig()
+  .then(data => {
+
+    if (data) {
+      if (data.config) {
+        // Check if typescript is used
+        const configFilePath = usesTypeScript ? './src/lib/config/index.ts' : './src/lib/config/index.js';
+
+        // Create and write to config file
+        const configFileText = \`export default \${JSON.stringify(data.config, null, 2)}\`;
+        fs.writeFileSync(configFilePath, configFileText, { encoding: 'utf8', flag: 'w' });
+
+        // Show that config was written
+        console.log(\`✅ Updated \` + chalk.bold(\`/src/lib/config/index.\${usesTypeScript ? 'ts' : 'js'}\`));
+      }
+
+      if (!global.arcGisApiKeyIsNull || !global.arcGisClientIdIsNull || !global.arcGisClientSecretIsNull) {
+        const envFilePath = path.join(process.cwd(), \`.env\`);
+        const envFileText = data.env;
+        fs.writeFileSync(envFilePath, envFileText, { encoding: 'utf8', flag: 'w' });
+
+        // Show that env was written
+        console.log(\`✅ Updated \` + chalk.bold(\`.env\`));
+        console.log(\`👀 Tip: Make sure your .gitignore has the line: .env\`);
+      }
+
+      // Show that generation was successful
+      console.log("");
+      console.log('🔥 Welcome to your ' + chalk.white.bgBlue('ArcGIS') + ' + ' + chalk.white.bgRed('SvelteKit') + ' app');
+
+      // Detect package manager
+      const hasPnpmLock = fs.existsSync(path.join(process.cwd(), 'pnpm-lock.yaml'));
+      const hasYarnLock = fs.existsSync(path.join(process.cwd(), 'yarn.lock'));
+
+      if (hasPnpmLock) {
+        console.log('👉 Now you can run \`' + chalk.white.green('pnpm run dev') + '\`');
+      } else if (hasYarnLock) {
+        console.log('👉 Now you can run \`' + chalk.white.green('yarn run dev') + '\`');
+      } else {
+        console.log('👉 Now you can run \`' + chalk.white.green('npm run dev') + '\`');
+      }
+
+    }
+
+  })
+  .catch(err => console.error('Error generating configuration:', err));
+`;
+
+fs.writeFileSync(initConfigPath, initConfigContent);
+console.log("✅ Created .config/init-sv-arcgis.js");
+
+// Add script
+if (!packageJson.scripts) packageJson.scripts = {};
+packageJson.scripts.config = 'SUPPRESS_NO_CONFIG_WARNING=true node ./.config/init-sv-arcgis.js';
+
+// Write back to package.json
+fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+
+console.log("✅ Added config script to package.json");
+console.log("");
+
+console.log("1️⃣  Please install required dependencies:");
+if (packageManager === 'pnpm') {
+  console.log("   pnpm add chalk cross-env prompts");
+  console.log("");
+
+  console.log("2️⃣  Then run:");
+  console.log("   pnpm run config");
+} else if (packageManager === 'yarn') {
+  console.log("   yarn add chalk cross-env prompts");
+  console.log("");
+
+  console.log("2️⃣  Then run:");
+  console.log("   yarn run config");
+} else {
+  console.log("   npm install --save chalk cross-env prompts");
+  console.log("");
+
+  console.log("2️⃣  Then run:");
+  console.log("   npm run config");
+}

package/index.js

@@ -0,0 +1 @@
+// console.log('Thanks for installing sv-arcgis');

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "sv-arcgis",
+  "version": "1.0.0",
+  "main": "index.js",
+  "bin": {
+    "sv-arcgis": "./bin/sv-arcgis-setup.js"
+  },
+  "scripts": {
+    "sematice-release": "semantic-release"
+  },
+  "keywords": [
+    "arcgis",
+    "sveltekit",
+    "svelte",
+    "cli",
+    "setup",
+    "scaffold",
+    "generator",
+    "esri",
+    "gis",
+    "mapping",
+    "geospatial",
+    "development",
+    "configuration",
+    "boilerplate",
+    "template"
+  ],
+  "author": "Joe Allen",
+  "license": "MIT",
+  "description": "a CLI tool that guides you through setting up a ArcGIS / SvelteKit development environment.",
+  "devDependencies": {
+    "semantic-release": "^24.2.7"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ]
+}