astoilkov/main-thread-scheduling

Health v2 · maintenance only

Adoption not part of the score

1331 stars · 33 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A TypeScript library for running computationally heavy tasks on the browser main thread without freezing the UI, using a simple yieldOrContinue() API. It schedules work with requestIdleCallback, isInputPending, and a global priority queue to keep apps responsive.

Use cases

• make a synchronous function non-blocking without web workers
• prevent UI freezes during heavy computation
• improve INP and Core Web Vitals scores
• run background tasks without spinning up fans
• prioritize rendering important elements first
• run multiple background tasks without degrading performance

When to choose

• you want to avoid the complexity of Web Workers while keeping the UI responsive
• you need fine-grained yielding inside long-running main-thread tasks
• you want a tiny, production-tested scheduling library with a simple API

When to avoid

• your task is purely CPU-bound and works well in a Web Worker with no DOM access needs
• you need true parallelism across multiple cores
• you are working outside a browser environment where scheduling APIs are unavailable

Facets

library · maturity active

concurrency scheduling developer-tools web-development frontend performance browser main-thread event-loop yield isinputpending inp web-vitals typescript non-blocking web-server nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="astoilkov/main-thread-scheduling")