# MrSwitch/hello.js

A Javascript RESTFUL API library for connecting with OAuth2 services, such as Google+ API, Facebook Graph and Windows Live Connect

Repository: https://github.com/MrSwitch/hello.js
Canonical: https://ross.abutalabs.com/products/hellojs
Homepage: https://adodson.com/hello.js/
Language: JavaScript
License: MIT
License Family: permissive
Last push: 2026-01-12T22:55:22+00:00

## Health v2 (maintenance only)
Score: 71/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 62, release rhythm 65, longevity 100
- inputs: {"age_days": 5481, "days_push": 233, "days_rel": 233, "gap_med": 2.0, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4620, forks 608 (observed 2026-08-28T04:08:55.160225+00:00)

## What it is
hello.js is a client-side JavaScript SDK for authenticating with OAuth2 (and OAuth1 via a proxy) web services and querying their REST APIs. It standardizes paths and responses across providers like Google, Facebook, and Windows Live Connect through a modular architecture.

## Use cases
- add social login with Google, Facebook, or Microsoft to a web app
- fetch a user's profile and contacts from OAuth providers
- upload photos or post status updates to social networks from the browser
- standardize OAuth2 authentication flows across multiple providers
- query REST APIs of social platforms with a unified interface

## When to choose
- you need client-side OAuth2 sign-in with multiple social providers in a browser app
- you want a unified, normalized API for several social networks instead of per-provider SDKs
- you need a lightweight, modular JavaScript library for social authentication

## When to avoid
- you need server-side or backend OAuth flows rather than browser-based authentication
- you only target a single provider and prefer its official first-party SDK
- you need modern, actively developed auth tooling - the project is in maintenance with a rewrite still in progress

## Facets
- artifact type: library
- maturity: maintenance
- function: auth, http-client, sdk
- domain: web-development, frontend, apis, security
- platform: browser
- tags: oauth2, oauth, social-login, client-side, rest-api, single-sign-on, javascript, nodejs

## Member repositories
- MrSwitch/hello.js (main) score 71

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:55.160225+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-29T18:19:39.407475+00:00, confidence not recorded.
  - readme: https://github.com/MrSwitch/hello.js (fetched 2026-08-28T04:08:55.160225+00:00, sha 63500f47d36d)
- Data as of 2026-08-30T08:39:29.467469+00:00.