You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
68 lines
2.6 KiB
68 lines
2.6 KiB
2 years ago
|
<p align="center">
|
||
|
|
<a href="https://travis-ci.org/BrowserSync/browser-sync" title="Travis branch">
|
||
|
|
<img src="https://img.shields.io/travis/BrowserSync/browser-sync/master.svg?style=flat-square&label=linux" />
|
||
|
|
</a><a href="https://www.npmjs.com/package/browser-sync">
|
||
|
|
<img src="https://img.shields.io/npm/dm/browser-sync.svg?style=flat-square" />
|
||
|
|
</a>
|
||
|
|
</p>
|
||
|
|
<p align="center">
|
||
|
|
<a href="https://www.npmjs.com/package/browser-sync" title="NPM version">
|
||
|
|
<img src="https://img.shields.io/npm/v/browser-sync.svg?style=flat-square" />
|
||
|
|
</a>
|
||
|
|
</p>
|
||
|
|
<p align="center"><a href="https://www.browsersync.io"><img src="https://raw.githubusercontent.com/BrowserSync/browsersync.github.io/master/public/img/logo-gh.png" /></a></p>
|
||
|
|
<p align="center">Keep multiple browsers & devices in sync when building websites.</p>
|
||
|
|
|
||
|
|
<p align="center">Follow <a href="https://twitter.com/browsersync">@Browsersync</a> on twitter for news & updates.</p>
|
||
|
|
|
||
|
|
## Features
|
||
|
|
|
||
|
|
Please visit [browsersync.io](https://browsersync.io) for a full run-down of features
|
||
|
|
|
||
|
|
## Requirements
|
||
|
|
|
||
|
|
Browsersync works by injecting an asynchronous script tag (`<script async>...</script>`) right after the `<body>` tag
|
||
|
|
during initial request. In order for this to work properly the `<body>` tag must be present. Alternatively you
|
||
|
|
can provide a custom rule for the snippet using [snippetOptions](https://www.browsersync.io/docs/options/#option-snippetOptions)
|
||
|
|
|
||
|
|
## Upgrading from 1.x to 2.x ?
|
||
|
|
Providing you haven't accessed any internal properties, everything will just work as
|
||
|
|
there are no breaking changes to the public API. Internally however, we now use an
|
||
|
|
immutable data structure for storing/retrieving options. So whereas before you could access urls like this...
|
||
|
|
|
||
|
|
```js
|
||
|
|
browserSync({server: true}, function(err, bs) {
|
||
|
|
console.log(bs.options.urls.local);
|
||
|
|
});
|
||
|
|
```
|
||
|
|
|
||
|
|
... you now access them in the following way:
|
||
|
|
|
||
|
|
```js
|
||
|
|
browserSync({server: true}, function(err, bs) {
|
||
|
|
console.log(bs.options.getIn(["urls", "local"]));
|
||
|
|
});
|
||
|
|
```
|
||
|
|
|
||
|
|
## Install and trouble shooting
|
||
|
|
|
||
|
|
[browsersync.io docs](https://browsersync.io)
|
||
|
|
|
||
|
|
## Integrations / recipes
|
||
|
|
|
||
|
|
[Browsersync recipes](https://github.com/Browsersync/recipes)
|
||
|
|
|
||
|
|
|
||
|
|
## Support
|
||
|
|
|
||
|
|
If 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!
|
||
|
|
|
||
|
|
[Support via PayPal](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=shakyshane%40gmail%2ecom&lc=US&item_name=browser%2dsync)
|
||
|
|
|
||
|
|
## Supported by
|
||
|
|
|
||
|
|
Originally supported by [JH](https://www.wearejh.com) - they provided financial support as well as access to a professional designer to help with Branding.
|
||
|
|
|
||
|
|
Apache 2
|
||
|
|
Copyright (c) 2021 Shane Osbourne
|