# balazsbotond/urlcat

A URL builder library for JavaScript.

Repository: https://github.com/balazsbotond/urlcat
Canonical: https://ross.abutalabs.com/products/urlcat
Homepage: https://urlcat.org
Language: TypeScript
License: MIT
License Family: permissive
Topics: url, builder, querystring, query-string
Last push: 2026-08-26T18:02:16+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 8, longevity 100
- inputs: {"age_days": 2178, "days_push": 7, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1871, forks 61 (observed 2026-08-28T04:05:46.855038+00:00)

## What it is
urlcat is a tiny JavaScript/TypeScript library for building URLs conveniently and correctly, handling path joining, query string construction, and escaping automatically. It prevents common mistakes like duplicate slashes and unencoded parameters when constructing request URLs.

## Use cases
- build URLs for HTTP API calls with dynamic path and query parameters
- concatenate base URLs and paths without duplicate slashes
- construct query strings with proper URL encoding
- build request URLs in TypeScript with type safety
- replace error-prone template literal URL construction

## When to choose
- you frequently build API request URLs in JavaScript or TypeScript
- you want a tiny, dependency-light library with a simple API
- you need automatic escaping and slash handling in URL construction

## When to avoid
- you only need to parse existing URLs rather than build them
- your runtime already provides the WHATWG URL API and you prefer zero dependencies
- you need complex URL manipulation like rewriting or normalization

## Facets
- artifact type: library
- maturity: stable
- function: http-client, developer-tools
- domain: web-development, developer-tools, apis
- platform: browser, cross-platform
- tags: url-builder, querystring, typescript, url-concatenation, nodejs

## Member repositories
- balazsbotond/urlcat (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:46.855038+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:15:01.053381+00:00, confidence not recorded.
  - readme: https://github.com/balazsbotond/urlcat (fetched 2026-08-28T04:05:46.855038+00:00, sha 1ace98923209)
  - registry_npm: https://registry.npmjs.org/urlcat (fetched 2026-08-29T10:54:10.689692+00:00, sha 5fdb0485ad7b)
- Data as of 2026-08-30T08:39:29.467469+00:00.