告別複製貼上樣板：用 BScaff 快速建立專案架構及程式碼片段

How many times have you started a new feature or microservice, only to spend the first 20 minutes copy-pasting .eslintrc, tsconfig.json, Dockerfiles, and boilerplate directory structures from an older project?

Or worse—you find an awesome directory structure generated by Claude or ChatGPT, and you sit there manually mkdir-ing and touch-ing every single file?

We've all been there:

• Boilerplate Fatigue: Re-creating the same folder hierarchy and setup logic across multiple repositories.
• Context Switching: Hunting through old codebases or browser tabs to find that one reusable snippet or setup script.
• Messy Template Repositories: Maintaining dozens of heavy, single-purpose GitHub starter templates for tiny scripts or components.

There has to be a better way to capture, store, and recreate developer resources without leaving the terminal.

Enter BScaff.

What is BScaff?

BScaff is a light, lightning-fast CLI tool designed to store, manage, and scaffold reusable developer resources. Think of it as a personal, command-line vault for:

• Entire project directory trees (tree)
• Multi-file bundles (files)
• Code and text snippets (snippet)
• Template packages with variable substitution (template)
• Web URLs (url)

Everything in BScaff revolves around a snapshot—a uniquely named key (-k) storing your saved content locally under ~/.bscaff.

Installation

Getting started takes seconds. Install BScaff globally via npm:

npm install -g @akashnag/bscaff

Verify the installation:

bscaff --version

5-Minute Quickstart Walkthrough

Let's dive into three everyday workflows where BScaff instantly saves you time.

1. Snapshotted Project Scaffolding

Say you have a starter React or Node.js template configured just the way you like it. Instead of creating a GitHub template repository or manually zip-copying folders, save it as a directory snapshot:

# Save your base project as a snapshot named 'node-base'
bscaff -k node-base --desc "Base Node.js Express setup" --tags node,express save tree ~/projects/my-node-starter

When you are ready to start a new service, extract it anywhere:

# Extract the snapshot into a new folder
bscaff -k node-base extract ./my-new-api

Boom! Your full directory structure and file contents are instantly created.

2. Turn AI-Generated Trees into Real Files instantly

AI coding assistants are great at generating project structures like this:

my-service/
├── src/
│   ├── controllers/
│   │   └── user.controller.ts
│   ├── routes/
│   │   └── user.routes.ts
│   └── index.ts
├── tests/
│   └── user.test.ts
└── package.json

Instead of manually creating these folders and files, copy that ASCII diagram directly to your clipboard and run:

bscaff create tree ./my-service --prompt-for-content

BScaff parses the tree diagram directly from your clipboard, constructs the complete directory hierarchy on disk, and interactively prompts you to supply content for each generated file.

3. Smart Snippets & Variable Substitutions

Need dynamic placeholders in your files? BScaff supports Mustache variable templates ({{ variable }}).

Suppose you have a component template containing:

// {{ componentName }}.tsx
export const {{ componentName }} = () => {
    return <div>Hello from {{ componentName }}</div>;
};

When extracting or generating from this snapshot, BScaff will automatically detect {{ componentName }}, prompt you for its value, and replace it across file paths and file contents seamlessly!

Feature Overview & Command Cheat Sheet

Here is a quick command reference to keep in your back pocket:

Bonus: BScaff's Hidden Superpowers

BScaff isn't just for project scaffolding—it has a few unexpected capabilities that can streamline your daily workflow.

1. Terminal URL Bookmarking

Stop cluttering your browser bookmark bar with docs you only use during development. Save URLs straight in BScaff:

# Bookmark official documentation or dashboards
bscaff -k go-docs save url https://go.dev/doc/

Whenever you need to jump back in, run:

# Automatically launches the URL in your default browser
bscaff -k go-docs open

2. Terminal Markdown Note-Taking

You can use BScaff as a persistent, zero-friction markdown scratchpad:

# Create a blank markdown note snapshot
bscaff -k sprint-notes save snippet --type md

Whenever you want to view or edit your notes, use the update content or open commands:

# Edit your markdown notes directly in your configured terminal text editor
bscaff -k sprint-notes update content

Ready to Streamline Your Workflow?

BScaff was built to eradicate repetitive setup tasks so you can focus on writing actual code.

Give it a try on your next project:

• 📦 npm Package: @akashnag/bscaff
• ⭐ GitHub Repository: akashnag/bscaff

If you find it helpful, drop a star on GitHub, share it with your team, and happy scaffolding! 🚀