# joewalnes/filtrex

A simple, safe, JavaScript Filter Expression compiler for end-users

Repository: https://github.com/joewalnes/filtrex
Canonical: https://ross.abutalabs.com/products/filtrex
Language: JavaScript
License: MIT
License Family: permissive
Last push: 2021-03-16T19:26:04+00:00

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

## Adoption (not part of the score)
Stars 1071, forks 73 (observed 2026-08-28T04:03:28.171014+00:00)

## What it is
Filtrex is a small JavaScript library that compiles a simple, spreadsheet-like filter expression language written by end-users into safe, fast JavaScript functions. It avoids eval() by sandboxing expressions so users can enter arbitrary filters without security risk.

## Use cases
- let end-users write filter expressions to search items
- compile user-entered expressions into safe javascript functions
- filter spreadsheet-like data with user-defined rules
- build a browser-based spreadsheet with custom formulas
- colorize or highlight items based on user expressions
- avoid eval() when evaluating user input

## When to choose
- you need end-users to enter simple filter or search expressions safely
- you want compiled, fast expression evaluation without eval()
- you need a tiny, predictable expression language with no loops or recursion

## When to avoid
- you need a full scripting language with loops, functions, or recursion
- you need complex types beyond numbers and strings
- you need an actively developed library with recent releases

## Facets
- artifact type: library
- maturity: maintenance
- function: parser, compiler, search-engine, security
- domain: developer-tools, web-development, frontend, parsers
- platform: browser, cross-platform
- tags: expression-language, expression-compiler, sandboxed-eval, user-input-filtering, runtime-compilation, javascript, nodejs

## Member repositories
- joewalnes/filtrex (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:28.171014+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-30T06:53:49.979233+00:00, confidence not recorded.
  - readme: https://github.com/joewalnes/filtrex (fetched 2026-08-28T04:03:28.171014+00:00, sha 7be4d9908eef)
- Data as of 2026-08-30T08:39:29.467469+00:00.
