{"id":22040355,"url":"https://github.com/inventsable/bombino-commands","last_synced_at":"2025-07-22T00:31:56.737Z","repository":{"id":36144080,"uuid":"221617183","full_name":"Inventsable/bombino-commands","owner":"Inventsable","description":"Adobe CEP utility commands to supercharge dev workflow available through Node scripts or via terminal","archived":false,"fork":false,"pushed_at":"2023-04-01T05:20:27.000Z","size":300,"stargazers_count":5,"open_issues_count":3,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-06-11T14:02:07.378Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Inventsable.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-11-14T05:15:00.000Z","updated_at":"2023-10-02T08:00:08.000Z","dependencies_parsed_at":"2024-06-21T04:19:29.130Z","dependency_job_id":"01e8b855-37de-4aa7-b2e3-25c1fd245595","html_url":"https://github.com/Inventsable/bombino-commands","commit_stats":{"total_commits":23,"total_committers":3,"mean_commits":7.666666666666667,"dds":"0.13043478260869568","last_synced_commit":"f51c33515ba8f46986685a56648209d817819b83"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Inventsable/bombino-commands","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Inventsable%2Fbombino-commands","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Inventsable%2Fbombino-commands/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Inventsable%2Fbombino-commands/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Inventsable%2Fbombino-commands/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Inventsable","download_url":"https://codeload.github.com/Inventsable/bombino-commands/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Inventsable%2Fbombino-commands/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266404941,"owners_count":23923491,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-21T11:47:31.412Z","response_time":64,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-30T11:14:13.892Z","updated_at":"2025-07-22T00:31:56.698Z","avatar_url":"https://github.com/Inventsable.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bombino-commands\n\nInterior panel commands for use within [bombino](https://github.com/Inventsable/bombino) panels\n\n```bash\nnpm install bombino-commands\n\n# Within root of bombino panel\nnpm run help\nnpm run switch\nnpm run update\nnpm run sign\nnpm run register\n\n# Within root of Adobe panel if manually installed\nbombino-cmd help\nbombino-cmd switch\nbombino-cmd update\nbombino-cmd register\nbombino-cmd sign\n```\n\n## Commands\n\n### `npm run help`:\n\n- Prompt a full list of commands of the panel including description and usage\n\n![](./assets/help.png)\n\n### ~~`npm run typescript`~~:\n\n\u003e Deprecated! Typescript support is added by default to all templates, awaiting the `tsc: watch` task on `tsconfig.json` from the user. For injection into any project use [scriptopia](https://github.com/Inventsable/scriptopia) instead, to see the results try [ovid-editor](https://ovid-editor.web.app/).\n\n### `npm run sign`:\n\n\u003e 🚩 This command only works if ZXPSignCmd.exe is located in the parent folder (eg .../cep/extensions/)\n\n- Duplicate and \"stage\" an extension folder to a temporary location, removing any hidden files or folders to ensure the certificate doesn't silently fail\n- Generate a temporary certificate\n- Sign the duplicate with the certificate\n- Check the validation of the signed duplicate\n- Place the resulting `[name][version].zxp` into `./archive` of your current panel (and create this folder if it doesn't already exist). If `[name][version].zxp` already exists, overwrite it\n- Delete the duplicate directory\n\n![](https://thumbs.gfycat.com/MintyGlossyBobolink-size_restricted.gif)\n\n### `npm run switch`:\n\n\u003e 🚩 This command only works if the panel was generated by [cep-vue-cli](https://github.com/Inventsable/generator-cep-vue-cli), [cep-quasar-cli](https://github.com/Inventsable/generator-cep-quasar-cli), or [bombino](https://github.com/Inventsable/bombino)\n\n- Report whether the manifest is currently prepped for `PRODUCTION` or `DEVELOPER` context.\n- Prompt the user if they'd like to switch contexts\n- If switching contexts, automatically adjusts `manifest.xml` for you (no need to manually open it and switch every time)\n- Prompt with contextual information about the next steps once the confirmation is made\n\n![](https://thumbs.gfycat.com/DemandingPaltryAlbatross-size_restricted.gif)\n\n### `npm run update`:\n\n- Report the current version of the panel\n- Prompt the user to update the MAJOR, MINOR, or MICRO tier\n- Auto-suggest the update as the next sequential number but allow any number to be entered\n- Rewrite the version number within `manifest.xml` and `package.json` with the updated semantic version\n\n![](https://thumbs.gfycat.com/CreepyLastBittern-size_restricted.gif)\n\n### `npm run register`:\n\n- Report the current string of text to use for `npm run sign` certification\n- Prompt the user for COUNTRY, STATE/LOCALE, ORGANIZATION, and COMMON NAME\n- Write a new file (or overwrite previous) containing country, locale, organization and user\n\n![](https://thumbs.gfycat.com/LonelyFemaleBobolink-size_restricted.gif)\n\n## Usage\n\n### (Assuming bombino default template)\n\nWhen you first create the template or need to start coding, you need `npm run serve` to launch the dev server and see your code reflect in the panel. If you want to build and sign an extension, then at any time you do so by running:\n\n- `npm run build` - This builds/compiles/gulps everything to the ./dist directory\n- `npm run switch` - This changes your manifest.xml file to point to the newly created ./dist/index.html compiled in the previous step. **Without this step, the ZXP will be pointing to a localhost which doesn't exist**\n- `npm run sign` - This stages, signs, and certifies the panel to create a deliverable ready for any one's use. **Note that if you want the certification info to be correct**, you must run `npm run register` at least once to fill out your own data (otherwise dummy data is used).\n\nTo continue development:\n\n- `npm run switch` - Change the manifest.xml back to the localhost for hot reloading\n- `npm run update` **[OPTIONAL]** - To avoid losing or overwriting previous code, it's a good idea to update the version after every `npm run sign`. This allows us to easily keep track of deliverables and stages, and hand off guaranteed deliverables without mixing them up.\n- `npm run serve` - Restart the development server and continue coding\n\nA one-step or odd number shift (`developer` \u003e `production` or vice versa) requires you restart the host application. A two-step or even number shift (`developer` \u003e `production` \u003e `developer`) requires only that you refresh the panel. This is because `manifest.xml` only reads once at the host app's launch, so switching it's entry point to change between `production` and `developer` will not be detected by the host app.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finventsable%2Fbombino-commands","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finventsable%2Fbombino-commands","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finventsable%2Fbombino-commands/lists"}