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?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


[![All Contributors](](#contributors-)

A JavaScript testing framework for the real world
By the way, you can ⭐️ the project to support it 😊

GitHub release Build Status Github All Releases npm License

Getting Started

To use EyeJS, you'll need to download EyeJS via NPM, and create a __test__ folder in your project folder, and put tests files in it. (NPM might require sudo on Mac).

$ npm install -g eye.js

Run EyeJS

EyeJS comes with a CLI:

$ eye

The full docs can be found here


EyeJS is a project that required a lot of work and effort. You can show your appreciation by leaving a ⭐️. But you can also contribute in a 'financial' way by giving some XMRs (if you have no idea of what this is, look for Monero on Google) at this address:



Please read for details on our code of conduct, and the process for submitting pull requests to us.

Made something using the EyeJS?

Add the built with EyeJS badge to your

Built with EyeJS

Feel free to send me an email at, and I might add your site to an examples section I'm currently working on.

Examples of projects using EyeJS


We use SemVer for versioning. For the versions available, see the tags on this repository.


  • Arthur Guiot - Initial work - @arguiot

Also look at the list of contributors who participated in this project. If you don't code but you have great ideas, don't hesitate to write your idea in the issue part. If your idea is accepted, I will add you to this list 😊.


This project is licensed under the MIT License - see the LICENSE file for details

Copyright © 2017 Arthur Guiot All Rights Reserved.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Arthur Guiot


Rex Tsou


This project follows the all-contributors specification. Contributions of any kind welcome!