Lit-based Add-on for Vaadin

You should start from this project, if your add-on be based on custom Lit HTML element and provide Java API for the rest of the application. As an example this project implements a simple clock-element to display current time based on browser.

For creating a simple wrapper for a JS module you might want to use the Component Starter repository as a template instead.

Development instructions

Important Files

Component implementation and API:

Clock.java: Add-on component Java class. Provides server-side Java API to use component in your applications.
clock-element.ts: TypeScript file that defines the client-side part of the component.
clock-element.css: Default styles for the component.

For testing and development:

TestView.java: A View class that let's you test the component you are building. This and other classes in the test folder will not be packaged during the build. You can add more test view classes in this package.
TestViewIT.java: Integration tests for the component. Uses TestView.java.
assembly/: this folder includes configuration for packaging the project into a JAR so that it works well with other Vaadin projects and the Vaadin Directory. There is usually no need to modify these files, unless you need to add JAR manifest entries.

Deployment

Starting the test/demo server:

mvn jetty:run

This deploys demo at http://localhost:8080

Integration test

To run Integration Tests, execute mvn verify -Pit,production.

Publishing to Vaadin Directory

You should change the organisation.name property in pom.xml to your own name/organization.

    <organization>
        <name>###author###</name>
    </organization>

You can create the zip package needed for Vaadin Directory using

mvn versions:set -DnewVersion=1.0.0 # You cannot publish snapshot versions 
mvn install -Pdirectory

The package is created as target/{project-name}-1.0.0.zip