open-index/open-npm huggingface dataset:
npm package: @scr2em/push-build
Description: Build and upload script for Ionic apps
Latest version: 1.0.3

# @scr2em/push-build

A command-line tool to build and upload Ionic apps

## 🚀 Quick Start

```bash
# 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:

```bash
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