Configuration

Srcpack looks for configuration in the following order:

1. srcpack.config.ts (recommended)
2. srcpack.config.js
3. srcpack field in package.json

Basic Structure

import { defineConfig } from "srcpack";

export default defineConfig({
  outDir: ".srcpack",
  bundles: {
    // bundle definitions
  },
  upload: {
    // optional upload config
  },
});

Options

Option	Type	Default	Description
root	string	process.cwd()	Project root directory
outDir	string	.srcpack	Output directory (relative to root)
emptyOutDir	boolean	true*	Empty output directory before bundling
bundles	object	—	Named bundles (required)
upload	object	—	Upload destination

*emptyOutDir defaults to true when outDir is inside project root.

root

Project root directory where files are bundled from. Can be absolute or relative to CWD.

export default defineConfig({
  root: "./packages/app", // bundle from subdirectory
  bundles: {
    app: "src/**/*", // matches packages/app/src/**/*
  },
});

outDir

Output directory for bundle files. Can be absolute or relative to project root.

export default defineConfig({
  root: "./packages/app",
  outDir: "dist", // writes to packages/app/dist/
  bundles: {
    app: "src/**/*",
  },
});

Bundle Definitions

Each bundle can be defined in three ways:

String (Simple Glob)

bundles: {
  app: "src/**/*",
}

Array (Multiple Patterns)

Use ! prefix to exclude:

bundles: {
  api: ["src/**/*", "!src/**/*.test.ts"],
}

Object (Full Options)

bundles: {
  docs: {
    include: "docs/**/*.md",
    outfile: "~/Downloads/docs.txt",
    index: false,
  },
}

Bundle options:

Option	Type	Default	Description
include	string | string[]	—	Glob pattern(s)
outfile	string	{outDir}/{name}.txt	Custom output path
index	boolean	true	Include index header
prompt	string	—	Text or file path (./, ~/) to prepend

Pattern Syntax

Patterns follow standard glob syntax with special prefixes:

Pattern	Matches
src/**/*	All files under src/
*.ts	TypeScript files in root
**/*.ts	TypeScript files anywhere
!**/*.test.ts	Exclude test files
+**/*.local.md	Force-include, bypass .gitignore
{src,lib}/**/*	Files in src/ or lib/

Force-Include (+ prefix)

Use + to include files that would normally be excluded by .gitignore:

bundles: {
  docs: [
    "docs/**/*",           // all docs (respects .gitignore)
    "+docs/**/*.local.md", // force-include local notes
  ],
}

Automatic Exclusions

Srcpack automatically excludes:

• Files matching .gitignore patterns
• Binary files (images, fonts, compiled assets)
• node_modules/
• .git/
• Lock files (package-lock.json, yarn.lock, etc.)

Examples

Monorepo

export default defineConfig({
  bundles: {
    web: "apps/web/**/*",
    api: "apps/api/**/*",
    shared: "packages/shared/**/*",
  },
});

Frontend + Backend

export default defineConfig({
  bundles: {
    client: ["src/client/**/*", "src/shared/**/*"],
    server: ["src/server/**/*", "src/shared/**/*"],
  },
});

Exclude Tests and Mocks

export default defineConfig({
  bundles: {
    app: [
      "src/**/*",
      "!src/**/*.test.ts",
      "!src/**/*.spec.ts",
      "!src/**/__mocks__/**",
    ],
  },
});

Code Review Bundle

export default defineConfig({
  bundles: {
    review: {
      include: "src/**/*",
      prompt: "./prompts/review.md", // or inline: "Review this code..."
    },
  },
});

Package.json Config

{
  "srcpack": {
    "bundles": {
      "app": "src/**/*"
    }
  }
}

Upload Configuration

Configure cloud upload destinations. See Google Drive Upload for setup details.

export default defineConfig({
  bundles: {
    /* ... */
  },
  upload: {
    provider: "gdrive",
    folderId: "1ABC...",
    clientId: process.env.GDRIVE_CLIENT_ID,
    clientSecret: process.env.GDRIVE_CLIENT_SECRET,
    exclude: ["local"], // skip these bundles
  },
});

Upload options:

Option	Type	Default	Description
provider	"gdrive"	—	Upload provider (required)
folderId	string	—	Target folder ID (optional)
clientId	string	—	OAuth client ID (required)
clientSecret	string	—	OAuth client secret (required)
exclude	string[]	—	Bundle names to skip during upload

TypeScript Support

The defineConfig helper provides type checking and autocomplete:

import { defineConfig } from "srcpack";

export default defineConfig({
  // Full autocomplete here
});