![](\"https://img.shields.io/travis/BrowserSync/browser-sync/master.svg?style=flat-square&label=linux\")
\n\n ![](\"https://img.shields.io/npm/dm/browser-sync.svg?style=flat-square\")
\n\n\n\n ![](\"https://img.shields.io/npm/v/browser-sync.svg?style=flat-square\")
\n\n
![](\"https://raw.githubusercontent.com/BrowserSync/browsersync.github.io/master/public/img/logo-gh.png\"){kind=logo}
Keep multiple browsers & devices in sync when building websites.
\n\nFollow @Browsersync on twitter for news & updates.
\n\n## Features\n\nPlease visit [browsersync.io](https://browsersync.io) for a full run-down of features\n\n## Requirements\n\nBrowsersync works by injecting an asynchronous script tag (``) right after the `` tag\nduring initial request. In order for this to work properly the `` tag must be present. Alternatively you\ncan provide a custom rule for the snippet using [snippetOptions](https://www.browsersync.io/docs/options/#option-snippetOptions)\n\n## Upgrading from 1.x to 2.x ?\nProviding you haven't accessed any internal properties, everything will just work as\nthere are no breaking changes to the public API. Internally however, we now use an\nimmutable data structure for storing/retrieving options. So whereas before you could access urls like this...\n\n```js\nbrowserSync({server: true}, function(err, bs) {\n console.log(bs.options.urls.local);\n});\n```\n\n... you now access them in the following way:\n\n```js\nbrowserSync({server: true}, function(err, bs) {\n console.log(bs.options.getIn([\"urls\", \"local\"]));\n});\n```\n\n## Install and trouble shooting\n\n[browsersync.io docs](https://browsersync.io)\n\n## Integrations / recipes\n\n[Browsersync recipes](https://github.com/Browsersync/recipes)\n\n\n## Support\n\nIf you've found Browser-sync useful and would like to contribute to its continued development & support, please feel free to send a donation of any size - it would be greatly appreciated!\n\n[Support via PayPal](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=shakyshane%40gmail%2ecom&lc=US&item_name=browser%2dsync)\n\n## Supported by\n\nOriginally supported by [JH](https://www.wearejh.com) - they provided financial support as well as access to a professional designer to help with Branding.\n\nApache 2\nCopyright (c) 2021 Shane Osbourne","users":{}}