Pattern Browser

A personal sewing pattern organizer. Browse, search, and manage a local collection of sewing patterns with metadata extracted automatically from your files.

Features

• Browse your pattern collection with thumbnail previews
• Auto-import and organize patterns from a drop folder
• Metadata extracted from filenames and PDF content
• Tag patterns and edit metadata through the UI
• Runs entirely locally as a web app (no cloud, no account)

Requirements

• Node.js 22+
• npm 10+

Getting Started

1. Install dependencies:

   npm install

2. Copy the example config and set your library location:

   cp config.example.json config.json
   # edit config.json — set baseDir to the parent of your import/ and library/ folders

3. Start the development server:

   npm run dev

   Open http://localhost:28008 in your browser.

Importing Patterns

Drop pattern files or folders into the import/ folder inside your baseDir. The app watches this folder and walks you through organizing each new item — auto-detecting the designer and pattern name, with a confirmation step before anything is moved.

Zip files are ignored during import.

Scripts

npm run dev     # start dev server with HMR on port 28008
npm start       # production mode (serves built client, opens browser)
npm run stop    # stop the running server
npm run build   # build the frontend to src/client/dist/
npm test        # run the test suite

start.sh / stop.sh are convenience wrappers for use as desktop shortcuts.

Project Structure

src/server/   Node.js + Express API
src/client/   Vue 3 SPA (Vite)

License

MIT