PackSmith: A minimal library for building packages.🚀

🚀 Build Lightning-Fast JavaScript/TypeScript Packages — Minus the Boilerplate

Tired of wasting hours setting up the same configs over and over again?
You're not alone.

Creating clean, reusable JS/TS packages should be easy — but it often turns into a slog: wiring up TypeScript, ESLint, test runners, bundlers, folder structures... every time. 😩

What if you could skip all of that and jump straight into coding?

Meet PackSmith — a minimal, opinionated library for building modern JS/TS packages.

No framework lock-in. No fluff. Just fast, clean, production-ready packages.

⚒️ What Is PackSmith?

PackSmith is a lightweight CLI + library that helps you scaffold and build framework-agnostic packages — ideal for utilities, SDKs, helpers, and core modules.

Run one command:

npx create-packsmith <project-name>

And you're ready to go with:

✅ TypeScript + ESLint + Vitest + TSUP
✅ Clean folder structure
✅ Handy build, test, and lint scripts
✅ Built-in utilities (no extra dependencies needed!)
✅ Zero clutter — just your code

🤔 Why PackSmith?

Most tools today are built for apps using frameworks like React, Vue, or Svelte. But if you're building reusable libraries — especially for backend or cross-platform environments — the setup can be repetitive and frustrating.

PackSmith is built specifically for library authors who want:

Preconfigured TypeScript and linting
A test runner that just works
No need to copy configs from old repos
A clean structure with no extra fluff
Minimal, type-safe utility functions built in

🧰 Comes With Built-in Utilities

PackSmith includes type-safe, dependency-free utilities to speed up development:

✅ Validation helpers
✅ Array and string manipulation functions
✅ Small, focused functions — no bloat

Fewer dependencies = smaller bundles + less to maintain.

🗂️ Example Project Layout

my-package/
├── .gitignore            # Git ignore rules
├── .npmignore            # Controls which files are published
├── eslint.config.mjs     # ESLint configuration
├── node_modules/         # Installed dependencies
├── package-lock.json     # npm lockfile
├── package.json          # Project metadata and scripts
├── README.md             # Project documentation
├── src/                  # Source code lives here
│   └── index.ts          # Entry point of your package
├── test/                 # Unit tests
│   └── index.test.ts     # Example test with Vitest
├── dist/                 # Build output (auto-generated by TSUP)
├── tsconfig.json         # TypeScript configuration
├── tsup.config.ts        # Build setup (TSUP)
└── vitest.config.ts      # Test runner config

Clean. Predictable. Production-ready.