.github/homebrew/README.homebrew.md

@@ -7,7 +7,7 @@ Stacks is available via Homebrew for macOS and Linux users, making installation
 The fastest way to install Stacks is with our one-line installation script:
 
 ```bash
-/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/stacksjs/stacks/main/.github/homebrew/install.sh)"
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/stacksjs/stacks/main/.github/scripts/install.sh)"
 ```
 
 This script:

.github/scripts/create-github-app.sh

@@ -6,15 +6,40 @@ echo "GitHub App Creation Helper for Stacks Homebrew Automation"
 echo "================================================================"
 echo
 
+# Try to load from .env file if it exists
+if [ -f ".env" ] || [ -f "../../.env" ]; then
+  source .env 2>/dev/null || source ../../.env 2>/dev/null
+fi
+
 if [ -z "$GITHUB_TOKEN" ]; then
-  echo "Please set the GITHUB_TOKEN environment variable with a personal access token that has"
-  echo "admin:org and repo permissions."
+  echo "❌ Error: GITHUB_TOKEN environment variable is not set"
+  echo
+  echo "To fix this, you need to:"
+  echo "1. Create a Personal Access Token (PAT):"
+  echo "   - Go to: https://github.com/settings/tokens/new"
+  echo "   - Click 'Generate new token (classic)'"
+  echo "   - Give it a name like 'Stacks Homebrew Automation'"
+  echo "   - Set expiration (recommended: 90 days)"
+  echo "   - Select these scopes:"
+  echo "     ✓ admin:org (Full control of orgs and teams)"
+  echo "     ✓ repo (Full control of private repositories)"
+  echo "   - Click 'Generate token' and copy the token"
   echo
-  echo "Example: GITHUB_TOKEN=your_token_here .github/scripts/create-github-app.sh"
+  echo "2. Set the token in one of these ways:"
+  echo "   a. Export it directly:"
+  echo "      export GITHUB_TOKEN=your_token_here"
+  echo "   b. Or add it to your .env file:"
+  echo "      echo 'GITHUB_TOKEN=your_token_here' >> .env"
+  echo
+  echo "3. Run this script again:"
+  echo "   ./github/scripts/create-github-app.sh"
+  echo
+  echo "Note: The token will only be shown once. Make sure to copy it!"
+  echo "      You can revoke it anytime at: https://github.com/settings/tokens"
   exit 1
 fi
 
-echo "1. Going to create a GitHub App via GitHub CLI..."
+echo "1. Going to help you create a GitHub App..."
 
 # Check if gh CLI is installed
 if ! command -v gh &> /dev/null; then
@@ -27,75 +52,85 @@ fi
 # Authenticate with GitHub CLI if needed
 gh auth status || (echo "Authenticating with GitHub CLI..." && echo "$GITHUB_TOKEN" | gh auth login --with-token)
 
-# Create manifest file for GitHub App
-cat > app-manifest.json << EOL
-{
-  "name": "Stacks Homebrew Automation",
-  "url": "https://github.com/stacksjs/stacks",
-  "hook_attributes": {
-    "active": false
-  },
-  "redirect_url": "https://github.com/stacksjs/stacks",
-  "public": false,
-  "default_permissions": {
-    "administration": "write",
-    "contents": "write",
-    "metadata": "read"
-  },
-  "default_events": []
-}
-EOL
-
-echo "2. Please complete the GitHub App creation process in your browser:"
-echo "   - You'll need to follow the link that appears below"
-echo "   - Click 'Create GitHub App' on the page that opens"
-echo "   - On the next page, note your App ID for the next step"
-echo "   - Generate a private key and download the .pem file"
+echo
+echo "2. Opening GitHub App creation page in your browser..."
+echo "   IMPORTANT: You need to create this app in the stacksjs organization!"
+echo "   - Go to: https://github.com/organizations/stacksjs/settings/apps/new"
+echo "   - If that doesn't work, go to github.com/stacksjs, click Settings → Developer settings → GitHub Apps → New GitHub App"
+echo
+echo "   Please fill in the following details:"
+echo "   - GitHub App name: Stacks Homebrew Automation"
+echo "   - Homepage URL: https://github.com/stacksjs/stacks"
+echo "   - Callback URL: (leave blank)"
+echo "   - Description: App for managing Homebrew tap for Stacks"
+echo
+echo "   - Webhook section:"
+echo "     ✗ Active: UNCHECK this box (this makes the URL and secret optional)"
+echo "     (With Active unchecked, you can ignore the Webhook URL and Secret fields)"
+echo
+echo "   - Under Repository permissions, select:"
+echo "     ✓ Contents: Read & write"
+echo "     ✓ Metadata: Read-only"
+echo
+echo "   - Under Organization permissions, select:"
+echo "     ✓ Administration: Read & write"
+echo
+echo "   - At the bottom, select 'Only on this account' for installation"
 echo
 
-echo "3. Opening GitHub App manifest creation flow..."
-gh api --method POST /organizations/stacksjs/github-apps/manifests \
-  --field manifest="$(cat app-manifest.json)" \
-  --jq '.html_url' | xargs open
+# Open the URL in the browser for the stacksjs organization
+open "https://github.com/organizations/stacksjs/settings/apps/new" 2>/dev/null || xdg-open "https://github.com/organizations/stacksjs/settings/apps/new" 2>/dev/null || echo "Please open this URL in your browser: https://github.com/organizations/stacksjs/settings/apps/new"
 
 echo
-echo "4. After completing the steps above, please enter the App ID: "
+echo "3. After clicking 'Create GitHub App':"
+echo "   a. You'll be redirected to the App settings page"
+echo "   b. Note your App ID (shown at the top)"
+echo "   c. Generate a private key by clicking 'Generate a private key'"
+echo "   d. Save the downloaded .pem file"
+echo
+
+echo "4. Please enter the App ID from the settings page: "
 read APP_ID
 
+if [ -z "$APP_ID" ]; then
+  echo "Error: No App ID provided"
+  exit 1
+fi
+
 echo
-echo "5. Please paste the path to the downloaded .pem private key file: "
+echo "5. Please enter the path to the downloaded .pem private key file: "
 read PEM_PATH
 
 if [ ! -f "$PEM_PATH" ]; then
   echo "Error: Private key file not found at $PEM_PATH"
   exit 1
 fi
 
-PRIVATE_KEY=$(cat "$PEM_PATH")
+PEM_KEY=$(cat "$PEM_PATH")
+
+echo "6. Successfully registered GitHub App with ID: $APP_ID"
 
 # Create GitHub repository secrets
-echo
-echo "6. Creating GitHub repository secrets..."
+echo "7. Creating GitHub repository secrets..."
 
 # Create secrets in the repository
 echo "Creating GH_APP_ID secret..."
 gh secret set GH_APP_ID -b"$APP_ID" -R stacksjs/stacks
 
 echo "Creating GH_APP_PRIVATE_KEY secret..."
-gh secret set GH_APP_PRIVATE_KEY -b"$PRIVATE_KEY" -R stacksjs/stacks
+gh secret set GH_APP_PRIVATE_KEY -b"$PEM_KEY" -R stacksjs/stacks
 
 echo
-echo "7. Installation:"
-echo "   - If you haven't already, install the app to your organization"
-echo "   - Navigate to the GitHub App page and click 'Install App'"
-echo "   - Choose 'Only select repositories' and select 'stacksjs/stacks'"
+echo "8. Installation:"
+echo "   - On the App settings page, click 'Install App' in the sidebar"
+echo "   - You should see the stacksjs organization listed"
+echo "   - Click 'Install' next to stacksjs"
+echo "   - On the next page, choose 'All repositories' or 'Only select repositories'"
+echo "   - If 'Only select repositories', make sure to select 'stacks'"
+echo "   - Click 'Install'"
 echo
 
 echo "Setup completed successfully!"
-echo
-echo "You can now run your GitHub Actions workflow, which will automatically"
-echo "create and manage the homebrew tap repository."
-echo "================================================================"
-
-# Clean up
-rm -f app-manifest.json
+echo "The GitHub App ID is: $APP_ID"
+echo "These values have been set as repository secrets."
+echo "================================================================"

.github/workflows/release.yml

@@ -1,4 +1,4 @@
-name: Release
+name: Releaser
 
 on:
   push:

README.md

@@ -382,7 +382,7 @@ We would like to extend our thanks to the following sponsors for funding Stacks
 
 ## Credits
 
-- [Laravel](https://laravel.com) _many thanks to their community_ 
+- [Laravel](https://laravel.com) _many thanks to their community_
 - [Chris Breuer](https://github.com/chrisbbreuer)
 - [All Contributors](../../contributors)
 

storage/framework/api/package.json

@@ -1,7 +1,7 @@
 {
   "name": "stacks-api",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "scripts": {
     "build": "bun build.ts",
     "dev": "bun --hot run dev.ts",

storage/framework/cloud/package.json

@@ -1,7 +1,7 @@
 {
   "name": "stacks-cloud",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "The Stacks cloud/serverless integration & implementation.",
   "author": "Chris Breuer",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/actions/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/actions",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "The Stacks actions.",
   "author": "Chris Breuer",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/ai/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/ai",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "Stacks Artificial Intelligence.",
   "author": "Chris Breuer",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/alias/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/alias",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "The Stacks aliases.",
   "author": "Chris Breuer",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/analytics/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/analytics",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "Stacks Analytics. Privacy-friendly.",
   "author": "Chris Breuer",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/api/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/api",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "The Stacks array utilities.",
   "author": "Chris Breuer",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/arrays/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/arrays",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "The Stacks array utilities.",
   "author": "Chris Breuer",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/auth/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/auth",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "A more simplistic way to authenticate.",
   "author": "Chris Breuer",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/browser/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/browser",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "Stacks core frontend/browser functionalities.",
   "author": "Chris Breuer",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/buddy/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/buddy",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "Meet Buddy. The Stacks runtime.",
   "author": "Chris Breuer",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/build/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/build",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "The Stacks framework build tools and configurations.",
   "author": "Chris Breuer",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/bun-create/bud/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bun-examples/bud",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "Your project description.",
   "author": "your-name <your-email>",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/bun-create/buddy/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bun-examples/buddy",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "Your project description.",
   "author": "your-name <your-email>",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/bun-create/stack/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bun-examples/stack",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "Your project description.",
   "author": "your-name <your-email>",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/bun-create/stacks/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bun-examples/stacks",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "Your project description.",
   "author": "your-name <your-email>",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/bun-create/stx/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bun-examples/stx",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "Your project description.",
   "author": "your-name <your-email>",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/cache/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/cache",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "Caching the Stacks way.",
   "author": "Chris Breuer",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/calendar/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/calendar-api",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "Easily interact with calendar APIs.",
   "author": "Chris Breuer",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/chat/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/chat",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "Easily interact with chat APIs.",
   "author": "Chris Breuer",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/cli",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "TypeScript framework for CLI artisans. Build beautiful console apps with ease.",
   "author": "Chris Breuer",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],

storage/framework/core/cloud/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/cloud",
   "type": "module",
-  "version": "0.70.17",
+  "version": "0.70.18",
   "description": "The Stacks cloud/serverless integration & implementation.",
   "author": "Chris Breuer",
   "contributors": ["Chris Breuer <chris@stacksjs.org>"],