bun-apps

bun-apps

Modern build tool for Google Apps Script development with Bun

Features

• 🚀 Fast builds with Bun
• 📦 TypeScript support out of the box
• 🔄 Automatic export to global functions
• 🛠️ Project scaffolding CLI
• 📝 Type-safe development with @types/google-apps-script

Installation

# Create new project
bunx bun-apps create

# Or add to existing project
bun add -d bun-apps

Usage

Create New Project

bunx bun-apps create

This will:

• Prompt for project name
• Copy template files
• Install dependencies
• Build the project
• Optionally create Apps Script project with clasp

Available Commands

# Build TypeScript to GAS
bunx bun-apps build

# Push code to Apps Script
bunx bun-apps push

# Deploy to Apps Script
bunx bun-apps deploy

# Open project in browser
bunx bun-apps open

How It Works

TypeScript to GAS Conversion

Input (index.ts):

function myFunction() {
	Logger.log('Hello via Bun!');
}

export { myFunction };

Output (dist/Code.gs):

function myFunction() {
	Logger.log('Hello via Bun!');
}

Project Structure

your-project/
├── index.ts              # Entry point
├── public/
│   └── appsscript.json   # GAS configuration
├── dist/
│   ├── Code.gs           # Built output
│   └── appsscript.json   # Copied configuration
├── package.json
└── tsconfig.json

API

buildGAS(options)

Build TypeScript code for Google Apps Script.

import { buildGAS } from 'bun-apps';

await buildGAS({
	srcDir: '.',
	distDir: './dist',
	publicDir: './public',
	entryFile: './index.ts',
	outputFile: './dist/Code.gs',
	packageJsonPath: './package.json',
	minify: false,
});

Options

Option	Type	Description
srcDir	string	Source directory
distDir	string	Output directory
publicDir	string	Public assets directory (optional)
entryFile	string	Entry point file
outputFile	string	Output file path
packageJsonPath	string	Path to package.json
minify	boolean	Enable minification (default: false)

Requirements

• Bun
• clasp (optional, for deployment)

Contributing

See CONTRIBUTING.md for development guidelines.

License

MIT