A collection of packages related to lit-html 2.0 and LitElement 3.0 work.

This branch is currently under active development. Please see the following links for details on the changes being made:

• Ideas for lit-html 2.0
• Ideas for LitElement 3.0
• lit-next issues/PRs in github

• Core packages
  • lit
  • lit-html
  • lit-element
  • @lit/reactive-element
• Additional libraries
  • @lit/localize
• Labs
  • @lit-labs/ssr
  • @lit-labs/react
  • @lit-labs/task
  • @lit-labs/scoped-registry-mixin
• Starter kits (not published to npm)
  • lit-starter-ts (template repo)
  • lit-starter-js (template repo)
• Internal packages (not published to npm)
  • tests
  • benchmarks

Initialize repo:

git clone https://github.com/Polymer/lit-html.git -b lit-next
cd lit-html
npm install
npm run bootstrap

Build all packages:

npm run build

Test all packages:

npm run test

Run benchmarks for all packages:

npm run benchmarks

See individual package READMEs for details on developing for a specific package.

Although we maintain lit-starter-ts and lit-starter-js in the monorepo for ease of integration testing, the source is exported back out to individual repos (ts, js) as these are GitHub Template Repositories with a nice workflow for users to create their own new element repos based on the template.

Use the following command to export new commits to the monorepo packages to a branch on the template repos (lit-next branch shown in example):

# Export TS template
git remote add lit-element-starter-ts git@github.com:PolymerLabs/lit-element-starter-ts.git
git subtree push --prefix=packages/lit-starter-ts/ lit-starter-element-ts lit-next

# Export JS template
git remote add lit-element-starter-js git@github.com:PolymerLabs/lit-starter-js.git
git subtree push --prefix=packages/lit-starter-js/ lit-starter-element-js lit-next

Notes:

• If your version of git did not come with git-subtree, you can add it by cloning the git source at git@github.com:git/git.git and symlinking git/contrib/subtree/git-subtree into your path (e.g. /usr/local/bin)
• If git subtree errors with a segmentation fault, try increasing your stack size prior to running, e.g. ulimit -s 16384