This documentation is a work in progress. It describes prerelease software, and is subject to change.
This page will take you through the steps you need to do to build and run the sample app locally.
This app depends on several npm packages, which you must be able to install. Make sure that you’ve already installed node.js and npm before moving on to the next step. If you already have
node installed, make sure you’re using the latest version – we recommend using
v8.0.0 and above.
Create a new app
To create a new app that uses the default
git clone --depth 1 https://github.com/Polymer/pwa-starter-kit my-app cd my-app
This will generate the initial project structure inside the
my-app folder, which roughly looks like this:
my-app ├── images | └── ... ├── src | └── ... ├── test | └── ... ├── index.html ├── README.md ├── package.json ├── polymer.json ├── manifest.json ├── service-worker.js ├── sw-precache-config.js ├── ... (misc project config files)
Checkout the folder structure page for details on what each file is used for.
To create a new app based on one of the other templates listed in Other templates, you can clone the appropriate branch from the
git clone --depth 1 -b <template-name> --single-branch https://github.com/Polymer/pwa-starter-kit my-app
For example, to start from Typescript template (
git clone --depth 1 -b template-typescript --single-branch https://github.com/Polymer/pwa-starter-kit my-app
To install the project’s dependencies, run
You’re now ready to run and see your app!
Run the app in development mode
To run the app locally, run
This will start a local server on port
8081. Open http://localhost:8081 to view your app in the browser. Note that this server can continue running as you’re making changes to your application, which you will see if you refresh the browser tab.
If the port is already taken on your computer, or if you need to change the default hostname (because you’re using a Docker container, for example), you can configure them using command line arguments:
npm start -- --hostname 0.0.0.0 --port 4444
Run the tests
Check out the Application testing page for more information about the tests. For a quick way to run the tests, run
npm run test
In the app’s root directory you can run:
npm startto run the application in development mode.
npm run testto run the application’s unit and integration tests (see the see the testing section for more details. To run just the unit or integration tests, both
npm run test:unitand
npm run test:integrationare available.
npm run buildto build your application for production (see the building and deploying section for more details).
npm run serveto serve the built application (see the building and deploying section for more details).
The complete list of scripts can be found in the
Now that you’re done with the basics of running your app, check out the next steps: