@scr2em/push-build

A command-line tool to build and upload Ionic apps

🚀 Quick Start

# Run directly with npx (no installation required)
npx @scr2em/push-build

# Or install globally
npm install -g @scr2em/push-build
push-build

📋 Prerequisites

• Node.js >= 14.0.0
• Ionic CLI >= 6.0.0 (npm install -g @ionic/cli)
• Git repository initialized
• Firebase project set up
• macOS/Linux with zip command available

🔧 What it does

This tool automates the entire build and upload process:

1. ✅ Runs ionic build
2. ✅ Collects git information (branch, commit)
3. ✅ Gets app version from package.json
4. ✅ Creates a zip file from the www folder
5. ✅ Authenticates with Firebase
6. ✅ Uploads to Firebase Storage
7. ✅ Saves build metadata to Firestore

📱 Usage

Run from your Ionic project root directory:

npx @scr2em/push-build

The tool will prompt you for:

• Firebase email
• Firebase password (hidden input with ****)

📊 Output

After successful upload, you'll get:

• Build ID: Unique identifier for this build
• Download URL: Direct download link
• File Size: Size of the uploaded build

The build will appear in the "Builds" tab of the Captello Updates Portal.

💻 Example

🐛 Troubleshooting

"www folder not found"

• Make sure you're running from your Ionic project root
• Ensure ionic build has been run successfully

"Authentication failed"

• Verify your Firebase credentials
• Check if your account has access to the project

"Git command failed"

• Ensure you're in a Git repository
• Make sure Git is installed and configured

"Permission denied"

• Check Firebase Storage permissions
• Verify your account has upload access

🔐 Security

• Password input is hidden with asterisks (****)
• No credentials are stored or logged
• Uses Firebase Authentication for secure access

📝 Requirements

Your Ionic project should have:

• package.json with version field
• www folder (created by ionic build)
• Git repository initialized

🔄 Changelog

v1.0.0

• Initial release
• Firebase integration
• Secure password input
• Automated build process

📄 License

MIT License