Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
September 27, 2023 10:58
August 22, 2023 00:02
September 21, 2023 13:33
March 21, 2023 22:09
July 27, 2023 19:38
November 15, 2021 13:42
September 14, 2023 15:35
September 19, 2023 23:12
August 21, 2023 06:00
August 21, 2023 06:00
September 27, 2023 11:01
August 21, 2023 06:00
August 21, 2023 06:00
August 21, 2023 06:00
August 21, 2023 06:00
August 21, 2023 05:14
August 21, 2023 06:00
August 21, 2023 05:14
Million.js Banner

What is Million.js?

Million.js is an extremely fast and lightweight (<4kb) virtual DOM that makes React components up to 70% faster.

Oh man... Another /virtual dom|javascript/gi framework? I'm fine with React already, why do I need this?

Million.js works with React. Million.js makes creating web apps just as easy (It's just wrapping a React component!), but with faster rendering and loading speeds. By using a fine-tuned, optimized virtual DOM, Million.js reduces the overhead of React (try it out here)

TL;DR: Imagine React components running at the speed of raw JavaScript.

πŸ‘‰ Setup Million.js in seconds! β†’


The Million.js CLI will automatically install the package and configure your project for you.

npx million@latest

β†’ View the installation guide


This repo is a "mono-repo" with modules. Million.js ships as one NPM package, but has first class modules for more complex, but important extensions. Each module has its own folder in the /packages directory.

You can also track our progress through our Roadmap.

Module Description
million The main Virtual DOM with all of Million.js's core.
react / react-server React compatibility for Million.js.
preact / preact-server Preact compatibility for Million.js.
compiler The compiler for Million.js in React.
jsx-runtime A simple JSX runtime for Million.js core.
types Shared types between packages

Resources & Contributing Back

Looking for the docs? Check the documentation or the Contributing Guide out. We also recommend reading Virtual DOM: Back in Block to learn more about Million.js's internals.

Want to talk to the community? Hop in our Discord and share your ideas and what you've build with Million.js.

Find a bug? Head over to our issue tracker and we'll do our best to help. We love pull requests, too!

We expect all Million.js contributors to abide by the terms of our Code of Conduct.

β†’ Start contributing on GitHub




Million.js takes heavy inspiration from the following projects:

  • blockdom (GΓ©ry Debongnie) Thank you to GΓ©ry pioneering the concept of "blocks" in the virtual DOM. Many parts of the Million.js codebase either directly or indirectly derive from his work.
  • voby (Fabio Spampinato) The Million.js "template" concept is derived from Voby's template() API.
  • Hack the Wave (Melinda Chang) for their homepage.
  • react and turbo for their documentation. Many parts of the current Million.js documentation are grokked and modified from theirs.
  • ivi, Preact, and more

Million.js is being used at companies like Wyze and Dimension, as well as open source work like Quartz, TinyPages, and more.


Million.js is MIT-licensed open-source software by Aiden Bai and contributors: