Quick start

1. Write a config

Create apotheke.config.mjs in your project root. There is no default group set — apotheke organises imports the way you describe, so this file is required.

export default {
    groups: [
        { name: 'React', match: ['react', 'react-dom'] },
        { name: 'Hooks', match: ['**/hooks/**'] },
        { name: 'Api', match: ['**/api/**', '@tanstack/react-query'] },
        { name: 'Navigation', match: ['@tanstack/react-router'] }
    ],
    groupSeparator: true,
    groupComments: true
};

Groups are matched in order, first match wins. Anything unmatched collects in an implicit Others group at the end, so you never lose an import by forgetting to describe it.

2. Wire it up

The plugin route — add apotheke last in the plugins array:

{
    "plugins": ["apotheke"]
}

Or use the CLI directly:

npx apotheke --write 'src/**/*.{ts,tsx}'

3. Preview before committing to it

Never run a repo-wide rewrite blind. Check what would change first:

npx apotheke --diff 'src/**/*.{ts,tsx}'

When the output looks right, apply it:

npx apotheke --write 'src/**/*.{ts,tsx}'

4. Keep it enforced

Add a CI check that fails when someone's imports drift:

npx apotheke --check 'src/**/*.{ts,tsx}'

--check exits 1 if any file would change and prints which ones.

Where to go next

• Configuring groups — matching rules, ordering, and the patterns that actually work
• Aliases and tsconfig paths — why @/lib/x already works
• Monorepos — one root config, per-package overrides
• Config reference — every option