🧪 Buddy Pond App Template

June 16, 2025 · View on GitHub

This is a ready-to-deploy template for building and hosting Buddy Pond Apps.

By forking this repo and connecting your GitHub account to Buddy Pond, you can automatically publish your static app files to your Buddy Pond App using GitHub Actions.

buddy-the-frog-256

🚀 How It Works

This repo includes a pre-configured Buddy Pond Upload Action that uploads your app files (like index.html, images, CSS, JavaScript, etc.) to your personal Buddy Pond storage space whenever you push to the main branch.

buddy-apps

✅ Quick Start

1. Fork this repo

Click “Use this template” to create your own copy under your GitHub account.

2. Generate a Buddy Pond API Key

Inside your Buddy Pond account:

  1. Open your Profile
  2. Navigate to API Keys
  3. Create a new API Key with the deploy permissions
  4. Copy the newly generated API Key

generate-api-keys.webm

3. Add Your Buddy Pond API Key to Github

In your new Github repo:

  1. Go to Settings → Secrets and variables → Actions → New repository secret
  2. Create a secret named BP_API_KEY
  3. Copy in your Buddy Pond API Key

3. Configure Your Upload Target

In .github/workflows/deploy.yml, update this section with your Buddy Pond info:

- uses: buddypond/upload-action@v1
  with:
    bp_api_key: ${{ secrets.BP_API_KEY }}
    user: YourBuddypondUsername
    folder: pads/your_app_folder

Note: Your target folder can be any path within your Buddy Files home. We recommend uploading to the pads directory.

Storage Limitations

Free Buddy Pond accounts default to 10mb of storage per user. Storage limits are linked to 1:1 to your BuddyCoin balance of $MEGA coins. You can acquire more $MEGA within Buddy Pond.