Skip to content

Releases: photon-hq/create-spectrum-project

create-spectrum-project v0.7.0

Choose a tag to compare

@photon-action-bot photon-action-bot released this 27 Jun 22:27

New Features

  • Added --projectId, so you can scaffold against an existing Spectrum Cloud project instead of creating a new one. The CLI can write PROJECT_ID and, when you choose to rotate the secret, PROJECT_SECRET into .env.

Bug Fixes

  • Fixed the existing-project flow so choosing not to rotate the project secret no longer requires Spectrum Cloud auth first.

Improvement

  • Updated --help, README examples, and tests around existing project setup so the new flow is easier to discover and safer to use. ✨

Version: 0.7.0

create-spectrum-project v0.6.0

Choose a tag to compare

@photon-action-bot photon-action-bot released this 26 Jun 01:48

New Features

  • Spectrum Cloud setup now works for all supported platform providers, not just iMessage. Selected platforms are passed into Cloud provisioning automatically. ✨

  • Added --platforms as a clearer alias for --providers, so commands like --platforms imessage,telegram now work.

Bug Fixes

  • Fixed Cloud provisioning for providers like whatsapp-business by normalizing platform names correctly before sending them to Spectrum Cloud.

  • Fixed Cloud project creation by always including iMessage when provisioning, since Spectrum Cloud requires it.

Improvement

  • Updated CLI help and README examples to use --platforms, while keeping --providers supported for compatibility.

  • Added focused unit coverage for platform flag parsing and Spectrum Cloud platform provisioning behavior.


Version: 0.6.0

create-spectrum-project v0.5.0

Choose a tag to compare

@photon-action-bot photon-action-bot released this 23 Jun 21:48

New Features

  • The CLI can now set up Spectrum Cloud during project creation for iMessage apps. It logs you in if needed, creates the cloud project, generates credentials, and writes them into .env. ✨
  • Added --no-cloud so you can skip cloud setup when you want to fill in credentials yourself.

Bug Fixes

  • The .env reminder now still appears when cloud setup fills PROJECT_ID and PROJECT_SECRET but provider-specific values, like TELEGRAM_BOT_TOKEN, are still empty.
  • Skill installation no longer creates extra agent folders for every registered agent. It now installs the Spectrum skill into the universal agent path only.

Improvement

  • New projects now include clearer AGENTS.md guidance for managing Spectrum Cloud with the photon CLI, including login, secret rotation, line listing, and project inspection.

Version: 0.5.0

create-spectrum-project v0.4.0

Choose a tag to compare

@photon-action-bot photon-action-bot released this 18 Jun 02:07

New Features

  • Added Telegram as a supported provider, so new projects can scaffold a Telegram bot alongside terminal, iMessage, and WhatsApp Business. 🎉
  • Telegram projects now generate the right telegram.config({ botToken: process.env.TELEGRAM_BOT_TOKEN! }) setup and include TELEGRAM_BOT_TOKEN in the generated environment files.

Improvement

  • Updated the generated .env.example and README setup guidance so provider-specific credentials show where they come from, like getting the Telegram bot token from @BotFather.
  • Added golden and unit test coverage for Telegram-only and all-platform scaffolds, making provider setup easier to validate going forward.

Version: 0.4.0

create-spectrum-project v0.3.1

Choose a tag to compare

@photon-action-bot photon-action-bot released this 09 Jun 02:53

Bug Fixes

  • Projects created with npm, pnpm, or yarn now get working start and dev scripts using tsx instead of Bun-only commands.
  • Generated TypeScript settings now match the selected package manager, so Node-based projects use Node types while Bun projects keep Bun types.

Improvement

  • Added coverage for package-manager-specific scaffolding so future changes are less likely to break generated project scripts. ✨

Version: 0.3.1

create-spectrum-project v0.3.0

Choose a tag to compare

@photon-action-bot photon-action-bot released this 27 May 01:43

New Features

  • New projects now include AGENTS.md and CLAUDE.md, so AI coding agents get Spectrum-specific project context right away.
  • The CLI now installs the spectrum agent skill by default, with a new prompt and --no-skills flag if you want to skip it. ✨

Bug Fixes

  • If skill installation fails, the CLI now gives a clearer retry command and uses the right runner for the environment (bunx under Bun, npx otherwise).
  • Skipping skills no longer shows an “Installing Spectrum skill…” status message.

Improvement

  • The README now matches the new flow, including updated bun create / npm create examples and the new skill-install option.
  • Added focused test coverage for skill installation, skip behavior, failure handling, and Claude auto-discovery setup.

Version: 0.3.0

create-spectrum-project v0.2.0

Choose a tag to compare

@photon-action-bot photon-action-bot released this 26 May 21:18

Breaking Changes

-y now defaults to the first platform provider, currently imessage, instead of terminal. Use --providers terminal if you want the local dev TUI behavior.

New Features

Generated platform projects now include a ready-to-fill .env alongside .env.example, so you can add credentials immediately without copying files first.

Bug Fixes

Generated README files now point to the correct Photon dashboard URL: https://app.photon.codes.

Improvement

The CLI now uses “Platforms” instead of “Production” in prompts and messaging, making the setup flow clearer for messaging interfaces. ✨


Version: 0.2.0

create-spectrum-project v0.1.1

Choose a tag to compare

@photon-action-bot photon-action-bot released this 26 May 04:12

Bug Fixes

  • Fixed the release workflow for the first npm publish by using NPM_TOKEN instead of OIDC trusted publishing. This lets create-spectrum-project v0.1.1 publish cleanly before trusted publishing is configured on npm. 🚀

Version: 0.1.1

create-spectrum-project v0.1.0

Choose a tag to compare

@photon-action-bot photon-action-bot released this 26 May 02:41
8e0c0bb

Key Features

  • Scaffold a new Spectrum project from one command, with providers wired up and a runnable echo loop in src/index.ts. ✨
  • Choose Terminal, iMessage, or WhatsApp Business through prompts, or skip prompts with flags for CI and repeatable setup.
  • Generates the basics for you: package.json, README.md, tsconfig.json, .gitignore, and .env.example when credentials are needed.
  • Supports Bun, npm, pnpm, and Yarn, with package manager detection and optional dependency installation.

Highlights

  • Uses the live spectrum-ts provider manifest when available, with a bundled fallback so project creation still works if the network is unavailable.
  • Pins generated projects to the current spectrum-ts release when possible, so new apps start on the latest compatible SDK.
  • Can initialize git and create an initial commit automatically, while still letting you opt out with --no-git or --no-install.
  • Provides both a friendly interactive flow and a scriptable CLI for teams that want consistent starter projects.

Version: 0.1.0