# Vaadin Core Elements [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/vaadin/vaadin-core-elements?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge) Vaadin Core Elements is an evolving set of custom HTML elements, built using [Polymer](https://www.polymer-project.org), for building mobile and desktop web applications in modern browsers. ### Examples and Documentation View live examples and source code side-by-side for individual custom elements. | Element | Description | Version | --- | --- | --- | | [<**vaadin-grid**>](https://github.com/vaadin/vaadin-grid) · [Docs](https://vaadin.com/docs/-/part/elements/vaadin-grid/overview.html) · [API](https://cdn.vaadin.com/vaadin-core-elements/latest/vaadin-grid/) | Data grid for showing large amounts of tabular data. | ![Bower version](https://img.shields.io/bower/v/vaadin-grid.svg) | | [<**vaadin-combo-box**>](https://github.com/vaadin/vaadin-combo-box) · [Examples](https://cdn.vaadin.com/vaadin-core-elements/master/vaadin-combo-box/demo/) · [API](https://cdn.vaadin.com/vaadin-core-elements/master/vaadin-combo-box/) | Filterable select element for a large set of items. | ![Bower version](https://img.shields.io/bower/v/vaadin-combo-box.svg) | ### Installation We offer three ways to use Vaadin Core Elements in your project: Bower, CDN and ZIP archive. The only difference between the options is the URL you use to import the necessary files into your HTML page. #### 1. Create a new folder for your project ```shell $ mkdir my-project $ cd my-project ``` #### 2. Install Vaadin Core Elements - ##### Bower We recommend using [Bower](http://bower.io) for managing your front-end dependencies. Follow the [Bower installation instructions](http://bower.io/#install-bower), then run the following command inside your project folder to install the most recent stable release. ```shell $ bower install --save vaadin-core-elements ``` This will download Vaadin Core Elements bundle and its dependencies to the `bower_components` folder inside your project's folder. If you wish to use the development snapshot version of some component, you can install/update that separately: ```shell $ bower install --save vaadin-grid#master ``` - ##### CDN You can use Vaadin Core Elements from CDN (see example below). This is especially convenient for services like JSFiddle, Codepen.io, etc. For example, to import vaadin-grid, use the following URL: `https://cdn.vaadin.com/vaadin-core-elements/latest/vaadin-grid/vaadin-grid.html` To import all Vaadin Core Elements, use the following URL: `https://cdn.vaadin.com/vaadin-core-elements/latest/vaadin-core-elements/vaadin-core-elements.html` > You can also use the nightly snapshot versions of any component, e.g. https://cdn.vaadin.com/vaadin-core-elements/master/vaadin-grid/vaadin-grid.html - ##### Download ZIP 1. Download the latest ZIP archive from [vaadin.com/download](https://vaadin.com/download#elements) 2. Extract the archive under your project folder, for example `deps` #### 3. Create a HTML file Create a new HTML file inside your project folder and copy the following code into it (choose one of the options how to import Vaadin Core Elements in the `` section): > **Serving the files during development**, when using Bower or the ZIP archive: > Due to browser security restrictions, serving HTML imports from a `file:///` URL does not work. You need a web server to view pages where you use custom elements. One simple option is to use the [`serve`](https://www.npmjs.com/package/serve) NPM package. ```html
# First Name Last Name Email
```