Thingy:52 Polymer and React web apps
This repository contains source code and instructions for building Polymer and React web apps showcasing the features of Thingy:52. To view the live version of the Polymer web app, click here, and to view the live version of the React web app, click here.
Apps
Polymer
The web app is built with Polymer 1.0 and uses the Web Bluetooth API to communicate with Thingy:52. The Web Bluetooth API is supported in the latest versions of Chrome and Opera on Android, Windows, Linux, Chrome OS and OS X. Check out the up to date list of implementation status in different browsers.
Recommendations
Prerequisites
Node.js
Install an active LTS version of Node.js (4.x or 6.x). The current version (7.x) should work, but is not officially supported.
Git
Install Git
Bower
npm install -g bower
Polymer-CLI
npm install -g polymer-cli
Installation instructions
- Clone this repository
- Make sure you have all prerequisites
- Browse inside the webapp-nordic-thingy folder and download dependencies with bower
bower install
- Start a local web server to test the project
polymer serve -o
The web app will open automatically in your default browser.
Build the project
Browse inside the project and use polymer-cli to build.
polymer build
This will create a new build folder. Inside is a bundled and unbundled folder. To learn more about the build process and the output please check out the official polymer-cli documentation.
Third-party licenses
three.js
MIT License
chart.js
MIT License
Polymer
Copyright (c) 2017 The Polymer Authors. All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are
met:
- Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
- Redistributions in binary form must reproduce the above
copyright notice, this list of conditions and the following disclaimer
in the documentation and/or other materials provided with the
distribution.
- Neither the name of Google Inc. nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
React
Recommendations
- This web app was built using a Web Bluetooth API which aims to make it easier to start developing Web Bluetooth applications using Thingy:52. To find out more about this API, click here.
- Learn about the Web Bluetooth API by reading the Interact with Bluetooth devices on the Web guide by François Beaufort.
- Learn about React by reading the official React - getting started guide.
- For an introduction in how to quickly and effortlessly create React apps, visit Create React App.
Prerequisites
- Node.js - Install an active LTS version of Node.js (e.g. v8.11.3). The current version (10.6.0) should work, but is not officially supported.
- Git - If you want to clone this repository, you will have to install Git. Alternatively, you can download the repository by clicking "Clone or download", and then "Download ZIP".
- Google Chrome - As Google Chrome is currently the only browser supporting Web Blueooth, you will need it to use the web app.
- Web Bluetooth polyfill for Windows 10 - If you are using Windows you will have to install a polyfill to enable Web Bluetooth. A guide with download and setup instructions can be found here. NOTE: As of January 2019, this polyfill is outdated, and it is recommended to use Chrome Canary instead, because it now has native Web Bluetooth support.
Notes
- Windows - Requires Windows 10 version 1706 (Creators Update) or later for the web bluetooth API to work properly.
Installation instructions
- Clone or download this repository.
- Make sure you have all prerequisites.
- Open a command line tool, navigate to the root folder of the repository, and download dependencies by typing:
npm i
- To test the project, type:
npm start
Build the project
From the root folder of the project, in a command line tool, write:
npm run build
This will create a new build folder. Inside is a bundled package of the website. The build can now be hosted by any server that is able to serve static files.
Note: If you want to serve the build from a folder other than the root folder, open the package.json file and change the "homepage" field to match your desired path.
Third-party licenses
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.