{"id":13482827,"url":"https://github.com/xebia/VisualReview","last_synced_at":"2025-03-27T13:32:53.592Z","repository":{"id":26619253,"uuid":"30074647","full_name":"xebia/VisualReview","owner":"xebia","description":"VisualReview, a human-friendly tool for testing and reviewing visual regressions.","archived":true,"fork":false,"pushed_at":"2020-02-10T20:58:02.000Z","size":2581,"stargazers_count":277,"open_issues_count":10,"forks_count":24,"subscribers_count":110,"default_branch":"master","last_synced_at":"2024-04-14T22:56:50.707Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/xebia/VisualReview#see-it-in-action","language":"Clojure","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xebia.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-01-30T14:12:27.000Z","updated_at":"2024-03-07T14:27:58.000Z","dependencies_parsed_at":"2022-09-01T20:51:54.394Z","dependency_job_id":null,"html_url":"https://github.com/xebia/VisualReview","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xebia%2FVisualReview","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xebia%2FVisualReview/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xebia%2FVisualReview/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xebia%2FVisualReview/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xebia","download_url":"https://codeload.github.com/xebia/VisualReview/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245854709,"owners_count":20683401,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T17:01:05.893Z","updated_at":"2025-03-27T13:32:53.195Z","avatar_url":"https://github.com/xebia.png","language":"Clojure","funding_links":[],"categories":["Clojure","Deprecated  (a-z↓)","Tools and frameworks"],"sub_categories":[],"readme":"# This project has been abandoned\nAs you might have noticed from the commit history, this project hasn't received the love it requires to keep it in working order. As maintainers have moved on to other projects and/or don't have the time to spend on it anymore, we decided to formally abandon this project. We'll keep it archived in Github so anyone willing to fork it is able to do so. Please note the permissions and limitations of the Apache license (see LICENSE file) when you do. Thanks!\n\n# \u003cimg src=\"https://cloud.githubusercontent.com/assets/205326/8749163/038588f4-2ca0-11e5-94f7-25074b6b1ee8.png\" alt=\"VisualReview logo\" height=\"40x\"\u003e \n[![Build Status](https://travis-ci.org/xebia/VisualReview.svg?branch=master)](https://travis-ci.org/xebia/VisualReview) [![Join the chat at https://gitter.im/xebia/VisualReview](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/xebia/VisualReview?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n\nVisualReview's goal is to provide a productive and human-friendly workflow for testing and reviewing your web application's layout for any regressions.\n\nVisualReview functions as a server which accepts screenshots of your web application, sent for example, from your selenium or protractor scripts.\nThese shots are then compared to screenshots you uploaded and reviewed earlier. VisualReview will display and highlight any differences\nbetween the two and allows you to either accept or reject these changes.\n\nCurrently VisualReview provides a [Protractor plug-in](https://www.github.com/xebia/VisualReview-protractor) to easily\nupload screenshots from your protractor tests. However, the VisualReview server has a simple API which allows\ncompatibility with other testing frameworks. We are working on other plug-ins and hope to release them soon.\n\n## See it in action\n![VisualReview visual regression tool in action](https://cloud.githubusercontent.com/assets/205326/8633297/1d86b464-27c1-11e5-85db-66cefbff4def.gif)\n\nAbove you can see how the application helps you to identify and evaluate visual changes in your application.\n\n## Getting started\nFor a **quick demo** try the [protractor example](https://github.com/xebia/VisualReview-protractor/blob/master/example-project/README.md).\n\nTo use VisualReview we'll start the VisualReview app itself. After that, we'll run tests that send screenshots to the server. \n\n### Configuring and starting the VisualReview server\n\n* Download and extract the [latest release](https://github.com/xebia/VisualReview/releases) or [build it and run from source](https://github.com/xebia/VisualReview/wiki/Building-and-running-from-source).\n* Reconfigure any settings in config.edn (optional)\n* Run `./start.sh`\n* Open your browser at [http://localhost:7000](http://localhost:7000) (or the port you configured in config.edn) to see if everything is working. It should list an empty project list.\n\n### Running your first test\n* Send screenshots during a test to VisualReview. We currently provide a [Protractor plug-in](https://www.github.com/xebia/VisualReview-protractor) to do this. See\nthe protractor-plugin's [README](https://github.com/xebia/VisualReview-protractor/blob/master/README.md) for details on how to configure Protractor to send screenshots to VisualReview.\n\n### Reviewing the results\n* Go back to the VisualReview page on http://localhost:7000 (or the port you configured in config.edn).\n* Navigate to your project and suite name. Here you see all the times you ran a test script against this project and suite combination.\n* Click on the run to review all screenshots and differences. If this is the first time you created a run in this suite, there will be no differences yet.\n* To approve or reject a screenshot, use the top-right menu or hit the 'a' or 'x' key on your keyboard.\n  * When you accept a screenshot, it will be added to this suite's so-called 'baseline'. Every future screenshot with that name inside the suite will be compared to this baseline.\n All screenshots you accept in future runs will overwrite this baseline. The baseline will therefore contain all latest accepted screenshots of a suite to which all new screenshots will be compared against.\n  * When you reject a screenshot, the baseline will not be updated.\n  * After you either accepted or rejected a screenshot, you can always revert this decision by selecting the 'pending' option in the top right menu.\n\n## Integration with other tools\nAn updated list of currently available integrations with other tools can be found [here](https://github.com/xebia/VisualReview/blob/master/doc/api.md#usages)\n\n## How to contribute\nVisualReview provides a REST API for easy integration with your own toolset. See the [API documentation](https://github.com/xebia/VisualReview/blob/master/doc/api.md) for more details.\n\nTo run or build the VisualReview project itself from source, see [this wiki page](https://github.com/xebia/VisualReview/wiki/Building-and-running-from-source).\n\n## Features in development \nFor our current- and future development focus, see the [wiki](https://github.com/xebia/VisualReview/wiki/Milestones). \n\n## Original authors and maintainers\nWe'd like to acknowledge the original authors of this project, from before version 0.1 and beyond:\n\n* [Joshua Appelman](https://github.com/jbnicolai)\n* [Daniel Marjenburgh](https://github.com/dmarjenburgh)\n* [Sannie Kwakman](https://github.com/skwakman)\n* [Ruurd Moelker](https://github.com/rrmoelker)\n\n## License\n\nCopyright © 2015 [Xebia](https://xebia.com/)\n\nDistributed under the [Apache License 2.0](http://http://www.apache.org/licenses/LICENSE-2.0).\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxebia%2FVisualReview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxebia%2FVisualReview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxebia%2FVisualReview/lists"}