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

``bash


Create new project

bunx gas-bun create

Or add to existing project

bun add -d gas-bun
`

Usage

$3

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

$3

`bash


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

$3

Input (index.ts):

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

export { myFunction };
`

Output (dist/Code.gs):

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

$3

`
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

$3

Build TypeScript code for Google Apps Script.

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