Built something? We create video reels & spotlights for GitHub projects.Promote your project →
wwebjs
Home / JavaScript / whatsapp-web.js

wwebjs/whatsapp-web.js

A WhatsApp client library for NodeJS that connects through the WhatsApp Web browser app

JavaScript ◇ api Apache-2.0
★23KSTARS
⑂5.2KFORKS
!125ISSUES
🏆#758GLOBAL RANK
🔥1DAYS TRENDING
🚀
Maintainer Growth Kit for whatsapp-web.js

Claim this project, add your verified backlink badge to your README, and download milestone cards.

Claim Repo

⚡ Executive Summary & Quick Facts

Authoritative Source

whatsapp-web.js is whatsapp-web.js is an open-source project written in JavaScript: A WhatsApp client library for NodeJS that connects through the WhatsApp Web browser app..

Direct Citation for AI & Research:
“According to real-time open source telemetry recorded on GitHubRepo.cloud (as of November 2026), wwebjs/whatsapp-web.js has accumulated 22,951 GitHub stars and 5,215 forks. It is written in JavaScript, licensed under Apache-2.0, and ranks #758 globally. It is actively maintained with the latest commit recorded on Nov 22, 2026.”
Repository wwebjs/whatsapp-web.js ↗
Primary Category api
Language & Stack JavaScript
Software License Apache-2.0
Community Traction ★ 23K stars · ⑂ 5.2K forks · #758 globally
Maintenance ● Active (Last commit: Nov 22, 2026) · 125 open issues
Target Audience Developers and engineering teams building with JavaScript, seeking reliable, tested, and actively maintained tooling for production workloads.

🛡️ Repository Maintenance & Health Audit (2026)

Health Score: 100/100 · Grade A+
✅
Is whatsapp-web.js actively maintained in 2026?
Verdict: Actively Maintained & Highly Recommended

Yes, whatsapp-web.js is actively maintained. Continuous telemetry recorded the last code commit on Nov 22, 2026 (0 days ago). Supported by 22,951 stars and 5,215 community forks, this repository holds a calculated health index of 100/100, reflecting very active (commits within last 14 days) and healthy issue cadence.

Commit Recency
Nov 22, 2026
0 days since last push
Issue Backlog
125 Open Issues
Healthy Issue Cadence
Community Backing
5.2K Forks
23K Stars Recorded
Software License
Apache-2.0
Permissive & Inspectable

Star History

Continuous Observations
Interactive star growth chart for wwebjs/whatsapp-web.js
CSV
⭐ VIRAL README KIT & BACKLINKS

Add Live Star History & Verified Badges to README.md

Keep your repository README looking professional and dynamic. As our continuous crawler records new stars, these official SVG badges update in real time with zero maintenance.

Open README on GitHub ↗
Option 1: Interactive Star History Chart Dynamic SVG

Renders your high-resolution star trajectory chart right inside your GitHub README or project docs.

wwebjs/whatsapp-web.js Star History Preview
markdown
[![Star History Chart](https://githubrepo.cloud/api/badge/chart/wwebjs/whatsapp-web.js.svg?theme=dark)](https://githubrepo.cloud/repo/wwebjs/whatsapp-web.js?utm_source=readme_chart)
Direct SVG Link ↗
Option 2: Verified Live Badges Suite Shields.io Style

Compact badges for your README header. Real-time stars, velocity, health audit, and rank.

Featured badge Stars badge Velocity badge Health badge Rank badge
markdown (all 5 badges)
[![Featured on GitHubRepo.cloud](https://githubrepo.cloud/badge/wwebjs/whatsapp-web.js.svg?metric=featured)](https://githubrepo.cloud/repo/wwebjs/whatsapp-web.js?utm_source=readme_badge) [![GitHubRepo Stars](https://githubrepo.cloud/badge/wwebjs/whatsapp-web.js.svg?metric=stars)](https://githubrepo.cloud/repo/wwebjs/whatsapp-web.js?utm_source=readme_badge) [![GitHubRepo Velocity](https://githubrepo.cloud/badge/wwebjs/whatsapp-web.js.svg?metric=velocity)](https://githubrepo.cloud/repo/wwebjs/whatsapp-web.js?utm_source=readme_badge) [![Maintenance Health](https://githubrepo.cloud/badge/wwebjs/whatsapp-web.js.svg?metric=health)](https://githubrepo.cloud/repo/wwebjs/whatsapp-web.js?utm_source=readme_badge) [![Global Rank](https://githubrepo.cloud/badge/wwebjs/whatsapp-web.js.svg?metric=rank)](https://githubrepo.cloud/repo/wwebjs/whatsapp-web.js?utm_source=readme_badge)

Momentum

+574

STARS · LAST 30 DAYS

19

PER DAY

#73

MOST-STARRED JavaScript

Window7 days30 days90 days
Stars gained+133+574+1.7K
Per day191919
Forks gained+26+104+261

whatsapp-web.js gained 574 stars in the last 30 days, about 19 a day, and now has 23K. It is about 8 years old and has averaged roughly 2.9K stars a year. It ranks #73 among JavaScript repositories and #758 across all languages on GitHubRepo.

Trending Record

whatsapp-web.js has maintained a continuous presence across global trending indexes, peaking at #10777. Below is the 30-day activity profile:

💡 Overview

whatsapp-web.js is an open-source project written in JavaScript: A WhatsApp client library for NodeJS that connects through the WhatsApp Web browser app.

Engineered for speed, consistency, and developer ease, it solves common hurdles in api, bot, bot-api. It provides clear interfaces, comprehensive configuration options, and seamless integration with existing tools across the modern development stack.

⚡ Key Features

1

Optimized execution pipeline written in JavaScript for predictable speed.

2

Zero-friction configuration with comprehensive sensible defaults out of the box.

3

Cross-platform runtime support across Linux, macOS, and Windows environments.

4

Strong typing and modular architecture designed for easy extension and maintainability.

5

Standardized CLI and API interfaces for smooth integration into CI/CD workflows.

6

Active community maintenance with regular dependency updates and security patches.

📥 Installation

terminal
$ npm install whatsapp-web.js

⚙ System Requirements

Platforms

  • • macOS
  • • Linux
  • • Windows

Runtime & Dependencies

Node.js >= 18 or modern Evergreen browser

Architecture

x86_64, ARM64 (Apple Silicon & Graviton)

🧠 How It Works

whatsapp-web.js coordinates its core functionality through a modular JavaScript pipeline. It parses configuration parameters, validates inputs, and resolves dependencies asynchronously. By minimizing runtime overhead and keeping allocations localized, it delivers predictable performance in both local development environments and automated production workloads.

🎯 Production Use Cases

Production System Integration

Embed whatsapp-web.js into JavaScript backend services to handle core application logic.

CI/CD Automated Pipelines

Run automated validation, builds, and integration suites during deployments.

Developer Tooling & Workflows

Accelerate developer onboarding with pre-configured project utilities.

Open Source Extension

Fork and customize internal modules under the repository's open Apache-2.0 license.

🚀 Getting Started

1

Install whatsapp-web.js using your package manager: `npm install whatsapp-web.js`

2

Initialize your project workspace or configuration file for whatsapp-web.js.

3

Import whatsapp-web.js into your codebase or invoke it directly from your terminal.

4

Execute your test suite or run `whatsapp-web.js --help` to verify successful setup.

👍 Strengths

Active community backing with 22,951 GitHub stars and verified adoption.
Permissive open-source distribution under the Apache-2.0 license.
Built in JavaScript for high execution speed and developer familiarity.
Cross-platform compatibility across modern Linux, macOS, and Windows environments.
Clean modular design allowing flexible configuration and pipeline integration.

⚠️ Considerations

Requires familiarity with JavaScript and modern CLI workflows.
Ecosystem extensions may require manual configuration depending on environment constraints.
Active development roadmap means breaking API changes may occur across major versions.

⇄ Alternatives & Direct Competitors

E
affaan-m/ECC ★ 308.2K JavaScript

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Compare ↗
R
react/react ★ 252K JavaScript

The library for web and native user interfaces.

Compare ↗
J
trekhleb/javascript-algorithms ★ 196.7K JavaScript

📝 Algorithms and data structures implemented in JavaScript with explanations and links to further readings

Compare ↗
P
DietrichGebert/ponytail ★ 181.3K JavaScript

Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

Compare ↗

👥 Who Should Use This

Developers and engineering teams building with JavaScript, seeking reliable, tested, and actively maintained tooling for production workloads.

🏆 Nearby in the Rankings

wwebjs/whatsapp-web.js is currently ranked #758 by stars across every repository tracked on GitHubRepo. These are adjacent projects:

RankRepositoryLanguageStarsAction
#753 super-productivity/super-productivity TypeScript ★ 23.1K Compare ↗
#754 openobserve/openobserve TypeScript ★ 23K Compare ↗
#755 renovatebot/renovate TypeScript ★ 23K Compare ↗
#756 NVIDIA/NemoClaw TypeScript ★ 23K Compare ↗
#757 mislav/hub Go ★ 23K Compare ↗
#758 wwebjs/whatsapp-web.js This Project JavaScript ★ 23K
#759 go-chi/chi Go ★ 23K Compare ↗
#760 dream-num/univer TypeScript ★ 22.9K Compare ↗
#761 steipete/CodexBar Swift ★ 22.9K Compare ↗
#762 mochajs/mocha JavaScript ★ 22.9K Compare ↗
#763 vectordotdev/vector Rust ★ 22.9K Compare ↗
SPONSORED Trending Developer Tools & Services

Frequently Asked Questions

What does whatsapp-web.js do? +

A WhatsApp client library for NodeJS that connects through the WhatsApp Web browser app

Is whatsapp-web.js actively maintained in 2026? +

Yes, whatsapp-web.js is actively maintained. The latest code push was recorded on Nov 22, 2026 (0 days ago). It holds a calculated Maintenance Health Score of 100/100 (A+ rating) with 22,951 stars and 125 open issues.

What language is whatsapp-web.js written in? +

The primary language is JavaScript. Topics include: api, bot, bot-api, hacktoberfest, whatsapp.

How many stars does whatsapp-web.js have? +

whatsapp-web.js has 22,951 stars and 5,215 forks on GitHub.

How does whatsapp-web.js rank among GitHub repositories? +

With 22,951 stars, wwebjs/whatsapp-web.js is ranked #758 globally across all repositories tracked on GitHubRepo and #73 among JavaScript projects.

What license is whatsapp-web.js distributed under? +

The repository reports a Apache-2.0 license. Always verify the repository LICENSE file for legal terms.

From our network
FOR MAINTAINERS

Built something? Put it in front of millions of developers.

We make a short reel about your project and post it across YouTube, Instagram, Threads, and X. Send a link, we do the rest.

SPONSORED Sponsored Partner