https://github.com/aplgr/business-toolbox

A small, self-hosted toolbox of practical calculators for freelancers - simple UI, transparent assumptions, works as static GitHub Pages.
https://github.com/aplgr/business-toolbox

alpinejs business-tools calculator consulting costs finance freelancer freelancing github-pages javascript planning pricing productivity rate-calculator static-site

Last synced: 9 days ago
JSON representation

A small, self-hosted toolbox of practical calculators for freelancers - simple UI, transparent assumptions, works as static GitHub Pages.

• Host: GitHub
• URL: https://github.com/aplgr/business-toolbox
• Owner: aplgr
• License: mit
• Created: 2026-01-27T17:44:06.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2026-05-06T20:53:29.000Z (28 days ago)
• Last Synced: 2026-05-06T22:35:40.270Z (27 days ago)
• Topics: alpinejs, business-tools, calculator, consulting, costs, finance, freelancer, freelancing, github-pages, javascript, planning, pricing, productivity, rate-calculator, static-site
• Language: HTML
• Homepage: https://tools.andreploeger.com
• Size: 164 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Business Toolbox

[![Demo: GitHub Pages](https://img.shields.io/badge/demo-GitHub%20Pages-2ea44f)](https://tools.andreploeger.com/)

[![Scope: Business Tools](https://img.shields.io/badge/scope-business%20tools-6f42c1)](https://github.com/aplgr/business-toolbox)

[![License: MIT](https://img.shields.io/github/license/aplgr/business-toolbox?label=license)](./LICENSE)

[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/aplgr/business-toolbox/pulls)

A small, static site that bundles a few practical calculators I use in real-world pricing, retainer, and B2B negotiation conversations.

## Included tools

- **Hourly Rate Calculator** (`tools/hourly-rate/`)

  - Derives an hourly (or day) rate from annual cost structure, unproductive days, and a configurable tax model.

  - Includes JSON presets + import/export.

- **Retainer Tier Evaluator** (`tools/retainer-tier/`)

  - Compares retainer tiers by MRR/ARR, effective rate, reserved capacity, and contract knobs (discount, overage, notice, term).

- **Freelancer-ROI-Check** (`tools/freelancer-roi-check/`)

  - Checks the ROI of a replacement decision based on ramp-up productivity, mentoring overhead, procurement hours, and optional cost-of-delay.

  - Includes JSON presets + import/export.

## Run locally

No build step. Any static server works.

```bash

npm install

npm run vendor:sync

make check-tools-json

python3 -m http.server 8080

# open http://localhost:8080

```

After Dependabot updates, run `npm install`, `npm run vendor:sync`, and `make check-tools-json`, then briefly test the static site locally.

## Notes / disclaimer

These tools are for modeling and decision support. They are **not** tax/legal advice and they may use simplified assumptions.

## Adding a new tool

1. Create a new folder under `tools//`.

2. Add a `tool.json` file inside that folder (required keys: `title`, `description`; optional: `tags`, `order`).

3. Run `make tools-json` to regenerate `tools.json`.

4. Commit your changes.

On GitHub, a workflow regenerates `tools.json` on pushes to `main` (and verifies it on pull requests).