ReviewOS

also looking at this

pantry-pm/pantry

chore(deps): update dependency @actions/github to v6

#11
Merged renovate[bot] wants to merge renovate/actions-github-6.x into main
4 files +230 -92
README.mdmodified+118-46
Changes to README.md
@@ -8,24 +8,46 @@
88
99# launchpad
1010
11> A lightweight package manager built on top of pkgx to simplify package installation and management. _Similar to Homebrew._
11> A lightweight package manager built on top of pkgx to simplify package installation and management. _Similar to Homebrew, but faster._
1212
1313## Features
1414
15Launchpad offers the following features:
15Launchpad offers a streamlined approach to package management with these key features:
1616
17- **Package Management** _Install and manage packages directly using pkgx_
18- **Executable Shims** _Create executable shims for packages automatically_
19- **pkgx Installation** _Install and manage the pkgx utility itself_
20- **Dev Environment** _Dedicated command for the dev package for development environments_
21- **Auto-updates** _Configure automatic updates for pkgx_
22- **PATH Integration** _Automatically add installation directories to your PATH_
23- **Cross-platform** _Support for macOS, Linux, and Windows systems_
17- **[Package Management](https://github.com/stacksjs/launchpad/tree/main/docs/features/package-management.md)** Install and manage packages efficiently using pkgx
18- **[Executable Shims](https://github.com/stacksjs/launchpad/tree/main/docs/features/shim-creation.md)** Create executable shims for packages automatically
19- **[pkgx Management](https://github.com/stacksjs/launchpad/tree/main/docs/features/pkgx-management.md)** Install and manage the pkgx utility itself
20- **[Dev Environment](https://github.com/stacksjs/launchpad/tree/main/docs/features/dev-package.md)** Dedicated command for the dev package for development environments
21- **Auto-updates** Configure automatic updates for pkgx
22- **[PATH Integration](https://github.com/stacksjs/launchpad/tree/main/docs/features/path-management.md)** Automatically add installation directories to your PATH
23- **Cross-platform** Full support for macOS, Linux, and Windows systems
24
25## Why Launchpad?
26
27Traditional package managers like Homebrew have limitations:
28
29- **Slow installations** Installing or updating can take minutes
30- **Dependency chains** Updating one package triggers unwanted updates
31- **Environment conflicts** Different projects need different versions
32- **PATH management** Manual PATH configuration is error-prone
33- **Platform inconsistency** Different systems need different approaches
34
35Launchpad solves these by providing:
36
37- **Fast installations** Leverage pkgx for efficient package management
38- **Isolated packages** Install only what you need without conflicts
39- **Automatic PATH management** Tools are available immediately
40- **Consistent interface** Same commands work everywhere
41- **Dev environments** Project-specific development environment support
42
43[Read more about why we created Launchpad](https://github.com/stacksjs/launchpad/tree/main/docs/why.md)
2444
2545## Installation
2646
47Launchpad is available through multiple package managers:
48
2749```bash
28# Install with Bun
50# Install with Bun (recommended)
2951bun add -g @stacksjs/launchpad
3052
3153# Or with npm
@@ -33,9 +55,14 @@ npm install -g @stacksjs/launchpad
3355
3456# Or with yarn
3557yarn global add @stacksjs/launchpad
58
59# Or with pnpm
60pnpm add -g @stacksjs/launchpad
3661```
3762
38## Usage
63See [Installation Guide](https://github.com/stacksjs/launchpad/tree/main/docs/install.md) for more options.
64
65## Quick Start
3966
4067### Install packages
4168
@@ -43,14 +70,14 @@ yarn global add @stacksjs/launchpad
4370# Install packages
4471launchpad install node python
4572
46# Use a shorthand
73# Use the shorthand
4774launchpad i node
4875```
4976
5077### Create shims
5178
5279```bash
53# Create shims for executables from packages
80# Create shims for executables
5481launchpad shim node typescript
5582
5683# Specify custom path
@@ -70,11 +97,11 @@ launchpad pkgx --force
7097### Install dev package
7198
7299```bash
73# Install the dev package for development environments
100# Install the dev package
74101launchpad dev
75102
76103# With customization
77launchpad dev --path ~/bin --force
104launchpad dev --path ~/bin
78105```
79106
80107### Configure auto-updates
@@ -90,45 +117,93 @@ launchpad autoupdate:enable
90117launchpad autoupdate:disable
91118```
92119
93### Customize PATH behavior
94
95```bash
96# Prevent automatic PATH modifications
97launchpad shim node --no-auto-path
98launchpad dev --no-auto-path
99```
100
101120### List installed packages
102121
103122```bash
104123# List all installed packages
105124launchpad list
106
107# Or use the shorthand
125# or
108126launchpad ls
109127```
110128
111129## Configuration
112130
113Launchpad uses a configuration file in your home directory at `~/.launchpadrc` or `.launchpad.json` in your project. Example configuration:
114
115```json
116{
117 "verbose": true,
118 "installationPath": "/usr/local",
119 "autoSudo": true,
120 "maxRetries": 3,
121 "timeout": 60000,
122 "symlinkVersions": true,
123 "forceReinstall": false,
124 "shimPath": "~/.local/bin",
125 "autoAddToPath": true
131Launchpad can be configured via a config file (`launchpad.config.ts`, `.launchpadrc`, etc.) or through command-line options.
132
133Example configuration:
134
135```ts
136import type { LaunchpadConfig } from '@stacksjs/launchpad'
137
138const config: LaunchpadConfig = {
139 // Enable verbose logging
140 verbose: true,
141
142 // Installation path for binaries
143 installationPath: '/usr/local',
144
145 // Auto-elevate with sudo when needed
146 autoSudo: true,
147
148 // Retry settings
149 maxRetries: 3,
150 timeout: 60000,
151
152 // Version handling
153 symlinkVersions: true,
154 forceReinstall: false,
155
156 // PATH management
157 shimPath: '~/.local/bin',
158 autoAddToPath: true,
126159}
160
161export default config
162```
163
164See [Configuration Guide](https://github.com/stacksjs/launchpad/tree/main/docs/config.md) for all options.
165
166## GitHub Action
167
168Launchpad provides a GitHub Action for CI/CD workflows:
169
170```yaml
171- name: Install Dependencies
172 uses: stacksjs/launchpad-installer@v1
173 with:
174 packages: node typescript bun
127175```
128176
177See [GitHub Action Documentation](https://github.com/stacksjs/launchpad/tree/main/packages/action/README.md) for details.
178
179## Advanced Usage
180
181Explore advanced topics in our documentation:
182
183- [Custom Shims](https://github.com/stacksjs/launchpad/tree/main/docs/advanced/custom-shims.md)
184- [Cross-platform Compatibility](https://github.com/stacksjs/launchpad/tree/main/docs/advanced/cross-platform.md)
185- [Performance Optimization](https://github.com/stacksjs/launchpad/tree/main/docs/advanced/performance.md)
186- [API Reference](https://github.com/stacksjs/launchpad/tree/main/docs/api/reference.md)
187
188## Comparing to Alternatives
189
190### vs Homebrew
191
192- **Speed**: Significantly faster installations
193- **Isolation**: Changes to one package don't affect others
194- **No formulas**: Access thousands of packages without custom formulas
195- **Less disk space**: Only install what you need
196
197### vs Manual Installation
198
199- **Simplicity**: Single command to install complex tools
200- **PATH management**: No need to manually edit shell config files
201- **Version control**: Easily install specific versions
202- **Consistency**: Same experience across all platforms
203
129204## Changelog
130205
131Please see our [releases](https://github.com/stackjs/launchpad/releases) page for more information on what has changed recently.
206Please see our [releases](https://github.com/stackjs/launchpad/releases) page for information on changes.
132207
133208## Contributing
134209
@@ -136,17 +211,14 @@ Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.
136211
137212## Community
138213
139For help, discussion about best practices, or any other conversation that would benefit from being searchable:
140
141[Discussions on GitHub](https://github.com/stacksjs/launchpad/discussions)
142
143For casual chit-chat with others using this package:
214For help or discussion:
144215
145[Join the Stacks Discord Server](https://discord.gg/stacksjs)
216- [Discussions on GitHub](https://github.com/stacksjs/launchpad/discussions)
217- [Join the Stacks Discord Server](https://discord.gg/stacksjs)
146218
147219## Postcardware
148220
149"Software that is free, but hopes for a postcard." We love receiving postcards from around the world showing where Stacks is being used! We showcase them on our website too.
221Two things are true: Stacks OSS will always stay open-source, and we do love to receive postcards from wherever Stacks is used! _We also publish them on our website. And thank you, Spatie_
150222
151223Our address: Stacks.js, 12665 Village Ln #2306, Playa Vista, CA 90094, United States
152224
bun.lockmodified+76-2
Changes to bun.lock
@@ -15,6 +15,24 @@
1515 "typescript": "^5.8.3",
1616 },
1717 },
18 "packages/action": {
19 "name": "launchpad-installer",
20 "version": "1.0.0",
21 "bin": {
22 "launchpad-installer": "dist/index.js",
23 },
24 "dependencies": {
25 "@actions/core": "^1.10.1",
26 "@actions/exec": "^1.1.1",
27 "@actions/github": "^6.0.1",
28 "@actions/io": "^1.1.3",
29 },
30 "devDependencies": {
31 "@types/node": "^20.10.7",
32 "bun-plugin-dtsx": "^0.21.12",
33 "typescript": "^5.3.3",
34 },
35 },
1836 "packages/launchpad": {
1937 "name": "@stacksjs/launchpad",
2038 "version": "0.0.0",
@@ -34,6 +52,16 @@
3452 "unconfig": "0.3.10",
3553 },
3654 "packages": {
55 "@actions/core": ["@actions/core@1.11.1", "", { "dependencies": { "@actions/exec": "^1.1.1", "@actions/http-client": "^2.0.1" } }, "sha512-hXJCSrkwfA46Vd9Z3q4cpEpHB1rL5NG04+/rbqW9d3+CSvtB1tYe8UTpAlixa1vj0m/ULglfEK2UKxMGxCxv5A=="],
56
57 "@actions/exec": ["@actions/exec@1.1.1", "", { "dependencies": { "@actions/io": "^1.0.1" } }, "sha512-+sCcHHbVdk93a0XT19ECtO/gIXoxvdsgQLzb2fE2/5sIZmWQuluYyjPQtrtTHdU1YzTZ7bAPN4sITq2xi1679w=="],
58
59 "@actions/github": ["@actions/github@6.0.1", "", { "dependencies": { "@actions/http-client": "^2.2.0", "@octokit/core": "^5.0.1", "@octokit/plugin-paginate-rest": "^9.2.2", "@octokit/plugin-rest-endpoint-methods": "^10.4.0", "@octokit/request": "^8.4.1", "@octokit/request-error": "^5.1.1", "undici": "^5.28.5" } }, "sha512-xbZVcaqD4XnQAe35qSQqskb3SqIAfRyLBrHMd/8TuL7hJSz2QtbDwnNM8zWx4zO5l2fnGtseNE3MbEvD7BxVMw=="],
60
61 "@actions/http-client": ["@actions/http-client@2.2.3", "", { "dependencies": { "tunnel": "^0.0.6", "undici": "^5.25.4" } }, "sha512-mx8hyJi/hjFvbPokCg4uRd4ZX78t+YyRPtnKWwIl+RzNaVuFpQHfmlGVfsKEJN8LwTCvL+DfVgAM04XaHkm6bA=="],
62
63 "@actions/io": ["@actions/io@1.1.3", "", {}, "sha512-wi9JjgKLYS7U/z8PPbco+PvTb/nRWjeoFlJ1Qer83k/3C5PHQi28hiVdeE2kHXmIL99mQFawx8qt/JPjZilJ8Q=="],
64
3765 "@algolia/autocomplete-core": ["@algolia/autocomplete-core@1.17.7", "", { "dependencies": { "@algolia/autocomplete-plugin-algolia-insights": "1.17.7", "@algolia/autocomplete-shared": "1.17.7" } }, "sha512-BjiPOW6ks90UKl7TwMv7oNQMnzU+t/wk9mgIDi6b1tXpUek7MW0lbNOUHpvam9pe3lVCf4xPFT+lK7s+e+fs7Q=="],
3866
3967 "@algolia/autocomplete-plugin-algolia-insights": ["@algolia/autocomplete-plugin-algolia-insights@1.17.7", "", { "dependencies": { "@algolia/autocomplete-shared": "1.17.7" }, "peerDependencies": { "search-insights": ">= 1 < 3" } }, "sha512-Jca5Ude6yUOuyzjnz57og7Et3aXjbwCSDf/8onLHSQgw1qW3ALl9mrMWaXb5FmPVkV3EtkD2F/+NkT6VHyPu9A=="],
@@ -340,6 +368,8 @@
340368
341369 "@eslint/plugin-kit": ["@eslint/plugin-kit@0.2.5", "", { "dependencies": { "@eslint/core": "^0.10.0", "levn": "^0.4.1" } }, "sha512-lB05FkqEdUg2AA0xEbUz0SnkXT1LcCTa438W4IWTUh4hdOnVbQyOJ81OrDXsJk/LSiJHubgGEFoR5EHq1NsH1A=="],
342370
371 "@fastify/busboy": ["@fastify/busboy@2.1.1", "", {}, "sha512-vBZP4NlzfOlerQTnba4aqZoMhE/a9HY7HRqoOPaETQcSQuWEIyZMHGfVu6w9wGtGK5fED5qRs2DteVCjOH60sA=="],
372
343373 "@floating-ui/core": ["@floating-ui/core@1.6.9", "", { "dependencies": { "@floating-ui/utils": "^0.2.9" } }, "sha512-uMXCuQ3BItDUbAMhIXw7UPXRfAlOAvZzdK9BWpE60MCn+Svt3aLn9jsPTi/WNGlRUu2uI0v5S7JiIUsbsvh3fw=="],
344374
345375 "@floating-ui/dom": ["@floating-ui/dom@1.1.1", "", { "dependencies": { "@floating-ui/core": "^1.1.0" } }, "sha512-TpIO93+DIujg3g7SykEAGZMDtbJRrmnYRCNYSjJlvIbGhBjRSNTLVbNeDQBrzy9qDgUbiWdc7KA0uZHZ2tJmiw=="],
@@ -420,6 +450,26 @@
420450
421451 "@nodelib/fs.walk": ["@nodelib/fs.walk@1.2.8", "", { "dependencies": { "@nodelib/fs.scandir": "2.1.5", "fastq": "^1.6.0" } }, "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg=="],
422452
453 "@octokit/auth-token": ["@octokit/auth-token@4.0.0", "", {}, "sha512-tY/msAuJo6ARbK6SPIxZrPBms3xPbfwBrulZe0Wtr/DIY9lje2HeV1uoebShn6mx7SjCHif6EjMvoREj+gZ+SA=="],
454
455 "@octokit/core": ["@octokit/core@5.2.1", "", { "dependencies": { "@octokit/auth-token": "^4.0.0", "@octokit/graphql": "^7.1.0", "@octokit/request": "^8.4.1", "@octokit/request-error": "^5.1.1", "@octokit/types": "^13.0.0", "before-after-hook": "^2.2.0", "universal-user-agent": "^6.0.0" } }, "sha512-dKYCMuPO1bmrpuogcjQ8z7ICCH3FP6WmxpwC03yjzGfZhj9fTJg6+bS1+UAplekbN2C+M61UNllGOOoAfGCrdQ=="],
456
457 "@octokit/endpoint": ["@octokit/endpoint@9.0.6", "", { "dependencies": { "@octokit/types": "^13.1.0", "universal-user-agent": "^6.0.0" } }, "sha512-H1fNTMA57HbkFESSt3Y9+FBICv+0jFceJFPWDePYlR/iMGrwM5ph+Dd4XRQs+8X+PUFURLQgX9ChPfhJ/1uNQw=="],
458
459 "@octokit/graphql": ["@octokit/graphql@7.1.1", "", { "dependencies": { "@octokit/request": "^8.4.1", "@octokit/types": "^13.0.0", "universal-user-agent": "^6.0.0" } }, "sha512-3mkDltSfcDUoa176nlGoA32RGjeWjl3K7F/BwHwRMJUW/IteSa4bnSV8p2ThNkcIcZU2umkZWxwETSSCJf2Q7g=="],
460
461 "@octokit/openapi-types": ["@octokit/openapi-types@24.2.0", "", {}, "sha512-9sIH3nSUttelJSXUrmGzl7QUBFul0/mB8HRYl3fOlgHbIWG+WnYDXU3v/2zMtAvuzZ/ed00Ei6on975FhBfzrg=="],
462
463 "@octokit/plugin-paginate-rest": ["@octokit/plugin-paginate-rest@9.2.2", "", { "dependencies": { "@octokit/types": "^12.6.0" }, "peerDependencies": { "@octokit/core": "5" } }, "sha512-u3KYkGF7GcZnSD/3UP0S7K5XUFT2FkOQdcfXZGZQPGv3lm4F2Xbf71lvjldr8c1H3nNbF+33cLEkWYbokGWqiQ=="],
464
465 "@octokit/plugin-rest-endpoint-methods": ["@octokit/plugin-rest-endpoint-methods@10.4.1", "", { "dependencies": { "@octokit/types": "^12.6.0" }, "peerDependencies": { "@octokit/core": "5" } }, "sha512-xV1b+ceKV9KytQe3zCVqjg+8GTGfDYwaT1ATU5isiUyVtlVAO3HNdzpS4sr4GBx4hxQ46s7ITtZrAsxG22+rVg=="],
466
467 "@octokit/request": ["@octokit/request@8.4.1", "", { "dependencies": { "@octokit/endpoint": "^9.0.6", "@octokit/request-error": "^5.1.1", "@octokit/types": "^13.1.0", "universal-user-agent": "^6.0.0" } }, "sha512-qnB2+SY3hkCmBxZsR/MPCybNmbJe4KAlfWErXq+rBKkQJlbjdJeS85VI9r8UqeLYLvnAenU8Q1okM/0MBsAGXw=="],
468
469 "@octokit/request-error": ["@octokit/request-error@5.1.1", "", { "dependencies": { "@octokit/types": "^13.1.0", "deprecation": "^2.0.0", "once": "^1.4.0" } }, "sha512-v9iyEQJH6ZntoENr9/yXxjuezh4My67CBSu9r6Ve/05Iu5gNgnisNWOsoJHTP6k0Rr0+HQIpnH+kyammu90q/g=="],
470
471 "@octokit/types": ["@octokit/types@13.10.0", "", { "dependencies": { "@octokit/openapi-types": "^24.2.0" } }, "sha512-ifLaO34EbbPj0Xgro4G5lP5asESjwHracYJvVaPIyXMuiuXLlhic3S47cBdTb+jfODkTE5YtGCLt3Ay3+J97sA=="],
472
423473 "@pkgr/core": ["@pkgr/core@0.2.4", "", {}, "sha512-ROFF39F6ZrnzSUEmQQZUar0Jt4xVoP9WnDRdWwF4NNcXs3xBTLgBUDoOwW141y1jP+S8nahIbdxbFC7IShw9Iw=="],
424474
425475 "@polka/url": ["@polka/url@1.0.0-next.28", "", {}, "sha512-8LduaNlMZGwdZ6qWrKlfa+2M4gahzFkprZiAt2TF8uS0qQgBizKXpXURqvTJ4WtmupWxaLqjRb2UCTe72mu+Aw=="],
@@ -540,7 +590,7 @@
540590
541591 "@types/ms": ["@types/ms@2.1.0", "", {}, "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA=="],
542592
543 "@types/node": ["@types/node@22.10.10", "", { "dependencies": { "undici-types": "~6.20.0" } }, "sha512-X47y/mPNzxviAGY5TcYPtYL8JsY3kAq2n8fMmKoRCxq/c4v4pyGNCzM2R6+M5/umG4ZfHuT+sgqDYqWc9rJ6ww=="],
593 "@types/node": ["@types/node@20.17.48", "", { "dependencies": { "undici-types": "~6.19.2" } }, "sha512-KpSfKOHPsiSC4IkZeu2LsusFwExAIVGkhG1KkbaBMLwau0uMhj0fCrvyg9ddM2sAvd+gtiBJLir4LAw1MNMIaw=="],
544594
545595 "@types/normalize-package-data": ["@types/normalize-package-data@2.4.4", "", {}, "sha512-37i+OaWTh9qeK4LSHPsyRC7NahnGotNuZvjLSgcPzblpHB3rrCJxAOgI5gCdKm7coonsaX1Of0ILiTcnZjbfxA=="],
546596
@@ -762,6 +812,8 @@
762812
763813 "base64-js": ["base64-js@1.5.1", "", {}, "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA=="],
764814
815 "before-after-hook": ["before-after-hook@2.2.3", "", {}, "sha512-NzUnlZexiaH/46WDhANlyR2bXRopNg4F/zuSA3OpZnllCUgRaOF2znDioDWrmbNVsuZk6l9pMquQB38cfBZwkQ=="],
816
765817 "binary-extensions": ["binary-extensions@2.3.0", "", {}, "sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw=="],
766818
767819 "birpc": ["birpc@0.2.19", "", {}, "sha512-5WeXXAvTmitV1RqJFppT5QtUiz2p1mRSYU000Jkft5ZUCLJIk4uQriYNO50HknxKwM6jd8utNc66K1qGIwwWBQ=="],
@@ -910,6 +962,8 @@
910962
911963 "defu": ["defu@6.1.4", "", {}, "sha512-mEQCMmwJu317oSz8CwdIOdwf3xMif1ttiM8LTufzc3g6kR+9Pe236twL8j3IYT1F7GfRgGcW6MWxzZjLIkuHIg=="],
912964
965 "deprecation": ["deprecation@2.3.1", "", {}, "sha512-xmHIy4F3scKVwMsQ4WnVaS8bHOx0DmVwRywosKhaILI0ywMDWPtBSku2HNxRvF7jtwDRsoEwYQSfbxj8b7RlJQ=="],
966
913967 "dequal": ["dequal@2.0.3", "", {}, "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA=="],
914968
915969 "destr": ["destr@2.0.3", "", {}, "sha512-2N3BOUU4gYMpTP24s5rF5iP7BDr7uNTCs4ozw3kf/eKfvWSIu93GEBi5m427YoyJoeOzQ5smuu4nNAPGb8idSQ=="],
@@ -1288,6 +1342,8 @@
12881342
12891343 "kolorist": ["kolorist@1.8.0", "", {}, "sha512-Y+60/zizpJ3HRH8DCss+q95yr6145JXZo46OTpFvDZWLfRCE4qChOyk1b26nMaNpfHHgxagk9dXT5OP0Tfe+dQ=="],
12901344
1345 "launchpad-installer": ["launchpad-installer@workspace:packages/action"],
1346
12911347 "leven": ["leven@3.1.0", "", {}, "sha512-qsda+H8jTaUaN/x5vzW2rzc+8Rw4TAQ/4KjB46IwK5VH+IlVeeeje/EoZRpiXvIqjFgK84QffqPztGI3VBLG1A=="],
12921348
12931349 "levn": ["levn@0.4.1", "", { "dependencies": { "prelude-ls": "^1.2.1", "type-check": "~0.4.0" } }, "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ=="],
@@ -1788,6 +1844,8 @@
17881844
17891845 "tslib": ["tslib@2.8.1", "", {}, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
17901846
1847 "tunnel": ["tunnel@0.0.6", "", {}, "sha512-1h/Lnq9yajKY2PEbBadPXj3VxsDDu844OnaAo52UVmIzIvwwtBPIuNvkjuzBlTWpfJyUbG3ez0KSBibQkj4ojg=="],
1848
17911849 "tunnel-agent": ["tunnel-agent@0.6.0", "", { "dependencies": { "safe-buffer": "^5.0.1" } }, "sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w=="],
17921850
17931851 "twoslash": ["twoslash@0.3.1", "", { "dependencies": { "@typescript/vfs": "^1.6.1", "twoslash-protocol": "0.3.1" }, "peerDependencies": { "typescript": "^5.5.0" } }, "sha512-OGqMTGvqXTcb92YQdwGfEdK0nZJA64Aj/ChLOelbl3TfYch2IoBST0Yx4C0LQ7Lzyqm9RpgcpgDxeXQIz4p2Kg=="],
@@ -1816,7 +1874,9 @@
18161874
18171875 "unconfig": ["unconfig@0.3.10", "", { "dependencies": { "@antfu/utils": "^0.7.5", "defu": "^6.1.2", "jiti": "^1.19.1", "mlly": "^1.4.0" } }, "sha512-tj317lhIq2iZF/NXrJnU1t2UaGUKKz1eL1sK2t63Oq66V9BxqvZV12m55fp/fpQJ+DDmVlLgo7cnLVOZkhlO/A=="],
18181876
1819 "undici-types": ["undici-types@6.20.0", "", {}, "sha512-Ny6QZ2Nju20vw1SRHe3d9jVu6gJ+4e3+MMpqu7pqE5HT6WsTSlce++GQmK5UXS8mzV8DSYHrQH+Xrf2jVcuKNg=="],
1877 "undici": ["undici@5.29.0", "", { "dependencies": { "@fastify/busboy": "^2.0.0" } }, "sha512-raqeBD6NQK4SkWhQzeYKd1KmIG6dllBOTt55Rmkt4HtI9mwdWtJljnrXjAFUBLTSN67HWrOIZ3EPF4kjUw80Bg=="],
1878
1879 "undici-types": ["undici-types@6.19.8", "", {}, "sha512-ve2KP6f/JnbPBFyobGHuerC9g1FYGn/F8n1LWTwNxCEzd6IfqTwUQcNXgEtmmQ6DlRrC1hrSrBnCZPokRrDHjw=="],
18201880
18211881 "unicode-canonical-property-names-ecmascript": ["unicode-canonical-property-names-ecmascript@2.0.1", "", {}, "sha512-dA8WbNeb2a6oQzAQ55YlT5vQAWGV9WXOsi3SskE3bcCdM0P4SDd+24zS/OCacdRq5BkdsRj9q3Pg6YyQoxIGqg=="],
18221882
@@ -1840,6 +1900,8 @@
18401900
18411901 "unist-util-visit-parents": ["unist-util-visit-parents@6.0.1", "", { "dependencies": { "@types/unist": "^3.0.0", "unist-util-is": "^6.0.0" } }, "sha512-L/PqWzfTP9lzzEa6CKs0k2nARxTdZduw3zyh8d2NVBnsyvHjSX4TWse388YrrQKbvI8w20fGjGlhgT96WwKykw=="],
18421902
1903 "universal-user-agent": ["universal-user-agent@6.0.1", "", {}, "sha512-yCzhz6FN2wU1NiiQRogkTQszlQSlpWaw8SvVegAc+bDxbzHgh1vX8uIe8OYyMH6DwH+sdTJsgMl36+mSMdRJIQ=="],
1904
18431905 "universalify": ["universalify@2.0.1", "", {}, "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw=="],
18441906
18451907 "unocss": ["unocss@66.0.0", "", { "dependencies": { "@unocss/astro": "66.0.0", "@unocss/cli": "66.0.0", "@unocss/core": "66.0.0", "@unocss/postcss": "66.0.0", "@unocss/preset-attributify": "66.0.0", "@unocss/preset-icons": "66.0.0", "@unocss/preset-mini": "66.0.0", "@unocss/preset-tagify": "66.0.0", "@unocss/preset-typography": "66.0.0", "@unocss/preset-uno": "66.0.0", "@unocss/preset-web-fonts": "66.0.0", "@unocss/preset-wind": "66.0.0", "@unocss/preset-wind3": "66.0.0", "@unocss/transformer-attributify-jsx": "66.0.0", "@unocss/transformer-compile-class": "66.0.0", "@unocss/transformer-directives": "66.0.0", "@unocss/transformer-variant-group": "66.0.0", "@unocss/vite": "66.0.0" }, "peerDependencies": { "@unocss/webpack": "66.0.0", "vite": "^2.9.0 || ^3.0.0-0 || ^4.0.0 || ^5.0.0-0 || ^6.0.0-0" }, "optionalPeers": ["@unocss/webpack", "vite"] }, "sha512-SHstiv1s7zGPSjzOsADzlwRhQM+6817+OqQE3Fv+N/nn2QLNx1bi3WXybFfz5tWkzBtyTZlwdPmeecsIs1yOCA=="],
@@ -1984,6 +2046,10 @@
19842046
19852047 "@iconify/utils/local-pkg": ["local-pkg@1.0.0", "", { "dependencies": { "mlly": "^1.7.3", "pkg-types": "^1.3.0" } }, "sha512-bbgPw/wmroJsil/GgL4qjDzs5YLTBMQ99weRsok1XCDccQeehbHA/I1oRvk2NPtr7KGZgT/Y5tPRnAtMqeG2Kg=="],
19862048
2049 "@octokit/plugin-paginate-rest/@octokit/types": ["@octokit/types@12.6.0", "", { "dependencies": { "@octokit/openapi-types": "^20.0.0" } }, "sha512-1rhSOfRa6H9w4YwK0yrf5faDaDTb+yLyBUKOCV4xtCDB5VmIPqd/v9yr9o6SAzOAlRxMiRiCic6JVM1/kunVkw=="],
2050
2051 "@octokit/plugin-rest-endpoint-methods/@octokit/types": ["@octokit/types@12.6.0", "", { "dependencies": { "@octokit/openapi-types": "^20.0.0" } }, "sha512-1rhSOfRa6H9w4YwK0yrf5faDaDTb+yLyBUKOCV4xtCDB5VmIPqd/v9yr9o6SAzOAlRxMiRiCic6JVM1/kunVkw=="],
2052
19872053 "@rollup/plugin-babel/rollup": ["rollup@2.79.2", "", { "optionalDependencies": { "fsevents": "~2.3.2" }, "bin": { "rollup": "dist/bin/rollup" } }, "sha512-fS6iqSPZDs3dr/y7Od6y5nha8dW1YnbgtsyotCVvoFGKbERG++CVRFv1meyGDE1SNItQA8BrnCw7ScdAhRJ3XQ=="],
19882054
19892055 "@rollup/plugin-node-resolve/@rollup/pluginutils": ["@rollup/pluginutils@5.1.4", "", { "dependencies": { "@types/estree": "^1.0.0", "estree-walker": "^2.0.2", "picomatch": "^4.0.2" }, "peerDependencies": { "rollup": "^1.20.0||^2.0.0||^3.0.0||^4.0.0" }, "optionalPeers": ["rollup"] }, "sha512-USm05zrsFxYLPdWWq+K3STlWiT/3ELn3RcV5hJMghpeAIhxfsUIg6mt12CBJBInWMV4VneoV7SfGv8xIwo2qNQ=="],
@@ -2054,6 +2120,8 @@
20542120
20552121 "babel-plugin-polyfill-corejs2/semver": ["semver@6.3.1", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA=="],
20562122
2123 "bun-types/@types/node": ["@types/node@22.10.10", "", { "dependencies": { "undici-types": "~6.20.0" } }, "sha512-X47y/mPNzxviAGY5TcYPtYL8JsY3kAq2n8fMmKoRCxq/c4v4pyGNCzM2R6+M5/umG4ZfHuT+sgqDYqWc9rJ6ww=="],
2124
20572125 "c12/chokidar": ["chokidar@4.0.3", "", { "dependencies": { "readdirp": "^4.0.1" } }, "sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA=="],
20582126
20592127 "c12/confbox": ["confbox@0.2.2", "", {}, "sha512-1NB+BKqhtNipMsov4xI/NnhCKp9XG9NamYp5PVm9klAT0fsrNPjaFICsCFhNhwZJKNh7zB/3q8qXz0E9oaMNtQ=="],
@@ -2224,6 +2292,10 @@
22242292
22252293 "@iconify/utils/local-pkg/pkg-types": ["pkg-types@1.3.1", "", { "dependencies": { "confbox": "^0.1.8", "mlly": "^1.7.4", "pathe": "^2.0.1" } }, "sha512-/Jm5M4RvtBFVkKWRu2BLUTNP8/M2a+UwuAX+ae4770q1qVGtfjG+WTCupoZixokjmHiry8uI+dlY8KXYV5HVVQ=="],
22262294
2295 "@octokit/plugin-paginate-rest/@octokit/types/@octokit/openapi-types": ["@octokit/openapi-types@20.0.0", "", {}, "sha512-EtqRBEjp1dL/15V7WiX5LJMIxxkdiGJnabzYx5Apx4FkQIFgAfKumXeYAqqJCj1s+BMX4cPFIFC4OLCR6stlnA=="],
2296
2297 "@octokit/plugin-rest-endpoint-methods/@octokit/types/@octokit/openapi-types": ["@octokit/openapi-types@20.0.0", "", {}, "sha512-EtqRBEjp1dL/15V7WiX5LJMIxxkdiGJnabzYx5Apx4FkQIFgAfKumXeYAqqJCj1s+BMX4cPFIFC4OLCR6stlnA=="],
2298
22272299 "@shikijs/core/@shikijs/engine-javascript/oniguruma-to-es": ["oniguruma-to-es@2.3.0", "", { "dependencies": { "emoji-regex-xs": "^1.0.0", "regex": "^5.1.1", "regex-recursion": "^5.1.1" } }, "sha512-bwALDxriqfKGfUufKGGepCzu9x7nJQuoRoAFp4AnwehhC2crqrDIAP/uN2qdlsAvSMpeRC3+Yzhqc7hLmle5+g=="],
22282300
22292301 "@shikijs/twoslash/@shikijs/core/hast-util-to-html": ["hast-util-to-html@9.0.5", "", { "dependencies": { "@types/hast": "^3.0.0", "@types/unist": "^3.0.0", "ccount": "^2.0.0", "comma-separated-tokens": "^2.0.0", "hast-util-whitespace": "^3.0.0", "html-void-elements": "^3.0.0", "mdast-util-to-hast": "^13.0.0", "property-information": "^7.0.0", "space-separated-tokens": "^2.0.0", "stringify-entities": "^4.0.0", "zwitch": "^2.0.4" } }, "sha512-OguPdidb+fbHQSU4Q4ZiLKnzWo8Wwsf5bZfbvu7//a9oTYoqD/fWpe96NuHkoS9h0ccGOTe0C4NGXdtS0iObOw=="],
@@ -2276,6 +2348,8 @@
22762348
22772349 "@vitest/eslint-plugin/@typescript-eslint/utils/@eslint-community/eslint-utils": ["@eslint-community/eslint-utils@4.7.0", "", { "dependencies": { "eslint-visitor-keys": "^3.4.3" }, "peerDependencies": { "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0" } }, "sha512-dyybb3AcajC7uha6CvhdVRJqaKyn7w2YKqKyAN37NKYgZT36w+iRb0Dymmc5qEJ549c/S31cMMSFd75bteCpCw=="],
22782350
2351 "bun-types/@types/node/undici-types": ["undici-types@6.20.0", "", {}, "sha512-Ny6QZ2Nju20vw1SRHe3d9jVu6gJ+4e3+MMpqu7pqE5HT6WsTSlce++GQmK5UXS8mzV8DSYHrQH+Xrf2jVcuKNg=="],
2352
22792353 "c12/chokidar/readdirp": ["readdirp@4.1.1", "", {}, "sha512-h80JrZu/MHUZCyHu5ciuoI0+WxsCxzxJTILn6Fs8rxSnFPh+UVHYfeIxK1nVGugMqkfC4vJcBOYbkfkwYK0+gw=="],
22802354
22812355 "changelogen/c12/chokidar": ["chokidar@4.0.3", "", { "dependencies": { "readdirp": "^4.0.1" } }, "sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA=="],
docs/intro.mdmodified+35-43
Changes to docs/intro.md
@@ -1,10 +1,8 @@
1<p align="center"><img src="https://github.com/stacksjs/rpx/blob/main/.github/art/cover.jpg?raw=true" alt="Social Card of this repo"></p>
1<p align="center"><img src="https://github.com/stacksjs/launchpad/blob/main/.github/art/cover.jpg?raw=true" alt="Social Card of Launchpad"></p>
22
33# Introduction
44
5> For a better developer experience.
6
7Launchpad is a lightweight package manager built on top of [pkgx](https://pkgx.sh), designed to simplify package installation and management. It provides a clean, intuitive interface with powerful features that make working with development tools and packages easier.
5> A lightweight package manager built on top of pkgx to simplify package installation and management.
86
97## What is Launchpad?
108
@@ -19,13 +17,13 @@ At its core, Launchpad leverages pkgx, a next-generation package runner that all
1917
2018## Key Features
2119
22- **Package Management** _Install and manage packages directly using pkgx_
23- **Executable Shims** _Create executable shims for packages automatically_
24- **pkgx Installation** _Install and manage the pkgx utility itself_
25- **Dev Environment** _Dedicated command for the dev package for development environments_
26- **Auto-updates** _Configure automatic updates for pkgx_
27- **PATH Integration** _Automatically add installation directories to your PATH_
28- **Cross-platform** _Support for macOS, Linux, and Windows systems_
20- **Package Management** Install and manage packages directly using pkgx
21- **Executable Shims** Create executable shims for packages automatically
22- **pkgx Installation** Install and manage the pkgx utility itself
23- **Dev Environment** Dedicated command for the dev package for development environments
24- **Auto-updates** Configure automatic updates for pkgx
25- **PATH Integration** Automatically add installation directories to your PATH
26- **Cross-platform** Support for macOS, Linux, and Windows systems
2927
3028## How It Works
3129
@@ -38,56 +36,50 @@ Launchpad works by managing the installation of pkgx and creating shims (executa
3836
3937Whether you're setting up a new development machine, working on multiple projects with different tooling requirements, or just want a cleaner way to manage your packages, Launchpad offers a streamlined experience for modern developers.
4038
41## Get Started
39## Quick Example
4240
43It's rather simple to get your package development started:
41Here's a simple example of how to use Launchpad:
4442
4543```bash
46# you may use this GitHub template or the following command:
47bunx degit stacksjs/ts-starter my-pkg
48cd my-pkg
49
50 # if you don't have pnpm installed, run `npm i -g pnpm`
51bun i # install all deps
52bun run build # builds the library for production-ready use
44# Install Launchpad
45bun add -g @stacksjs/launchpad
5346
54# after you have successfully committed, you may create a "release"
55bun run release # automates git commits, versioning, and changelog generations
56```
47# Install Node.js
48launchpad install node
5749
58_Check out the package.json scripts for more commands._
50# Create shims for Node.js
51launchpad shim node
5952
60### Developer Experience (DX)
61
62This Starter Kit comes pre-configured with the following:
53# Now 'node' is available in your PATH
54node --version
55```
6356
64- [Powerful Build Process](https://github.com/oven-sh/bun) - via Bun
65- [Fully Typed APIs](https://www.typescriptlang.org/) - via TypeScript
66- [Documentation-ready](https://vitepress.dev/) - via VitePress
67- [CLI & Binary](https://www.npmjs.com/package/bunx) - via Bun & CAC
68- [Be a Good Commitizen](https://www.npmjs.com/package/git-cz) - pre-configured Commitizen & git-cz setup to simplify semantic git commits, versioning, and changelog generations
69- [Built With Testing In Mind](https://bun.sh/docs/cli/test) - pre-configured unit-testing powered by [Bun](https://bun.sh/docs/cli/test)
70- [Renovate](https://renovatebot.com/) - optimized & automated PR dependency updates
71- [ESLint](https://eslint.org/) - for code linting _(and formatting)_
72- [GitHub Actions](https://github.com/features/actions) - runs your CI _(fixes code style issues, tags releases & creates its changelogs, runs the test suite, etc.)_
57With just a few commands, you've installed Node.js and made it available in your PATH. Launchpad handles all the complexity for you.
7358
74## Changelog
59## Why Choose Launchpad?
7560
76Please see our [releases](https://github.com/stacksjs/stacks/releases) page for more information on what has changed recently.
61Launchpad offers several advantages over traditional package managers:
7762
78## Stargazers
63- **Speed**: Installing packages is significantly faster
64- **Isolation**: Changes to one package don't affect others
65- **Simplicity**: Clean, consistent interface across platforms
66- **Integration**: Automatic PATH management and environment configuration
67- **Flexibility**: Works with project-specific development environments
7968
80[![Stargazers](https://starchart.cc/stacksjs/ts-starter.svg?variant=adaptive)](https://starchart.cc/stacksjs/ts-starter)
69## Next Steps
8170
82## Contributing
71Ready to get started with Launchpad? Check out these guides:
8372
84Please review the [Contributing Guide](https://github.com/stacksjs/contributing) for details.
73- [Installation Guide](./install.md) Install Launchpad on your system
74- [Basic Usage](./usage.md) Learn the basic commands
75- [Configuration](./config.md) Customize Launchpad to your needs
76- [Why Launchpad?](./why.md) More details on the advantages of Launchpad
8577
8678## Community
8779
8880For help, discussion about best practices, or any other conversation that would benefit from being searchable:
8981
90[Discussions on GitHub](https://github.com/stacksjs/stacks/discussions)
82[Discussions on GitHub](https://github.com/stacksjs/launchpad/discussions)
9183
9284For casual chit-chat with others using this package:
9385
packages/action/package.jsonmodified+1-1
Changes to packages/action/package.json
@@ -33,7 +33,7 @@
3333 "dependencies": {
3434 "@actions/core": "^1.10.1",
3535 "@actions/exec": "^1.1.1",
36 "@actions/github": "^5.1.1",
36 "@actions/github": "^6.0.1",
3737 "@actions/io": "^1.1.3"
3838 },
3939 "devDependencies": {