gas-bun

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 gas-bun create

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

Usage

Create New Project

bunx gas-bun create

This will:

1. Prompt for project name
2. Copy template files
3. Install dependencies
4. Build the project
5. Optionally create Apps Script project with clasp

Available Commands

# Build TypeScript to GAS
bunx gas-bun build

# Push code to Apps Script
bunx gas-bun push

# Deploy to Apps Script
bunx gas-bun deploy

# Open project in browser
bunx gas-bun 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 'gas-bun';

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