# stencil
> Asynchronous HTML5 and XML templates for Node.js and the browser.
Latest version **0.0.5** (published 2013-04-22) · 0 weekly downloads
## Install
```sh
npm install stencil
pnpm add stencil
yarn add stencil
bun add stencil
```
## Health
**Score 15/100 (F)** — status: abandoned.
Positive: no vulnerabilities.
Warnings: low downloads; no types; no esm support; pre 1.0.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 0.0.5 |
| Published | 2013-04-22 |
| First published | 2012-07-22 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Known vulnerabilities | 0 (+16 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 9 |
| Author | Alan Gutierrez |
| Maintainers | bigeasy |
| Keywords | template, html, xml, text, xhtml, async, asynchronous |
## Links
- npm: https://www.npmjs.com/package/stencil
- Repository: http://github.com/bigeasy/stencil
- Homepage: https://github.com/bigeasy/stencil
- npm.io page: https://npm.io/package/stencil
## Dependencies (1)
- [xmldom](https://npm.io/package/xmldom.md) 0.1.15
## Alternatives
- [babylon](https://npm.io/package/babylon.md) — 5.1M weekly downloads
- [csscolorparser](https://npm.io/package/csscolorparser.md) — 3.7M weekly downloads
- [expr-eval-fork](https://npm.io/package/expr-eval-fork.md) — 1.5M weekly downloads
- [@leeoniya/ufuzzy](https://npm.io/package/@leeoniya/ufuzzy.md) — 247.7K weekly downloads
- [xml-parser](https://npm.io/package/xml-parser.md) — 78.4K weekly downloads
## Recent versions
- 0.0.5 (latest) — 2013-04-22
- 0.1.0-alpha.1 (canary) — 2021-01-25
- 0.1.0-alpha.0 — 2021-01-25
- 0.0.4 — 2013-04-16
- 0.0.3 — 2013-04-12
- 0.0.2 — 2013-04-06
- 0.0.1 — 2012-07-22
## README
# Stencil [](http://travis-ci.org/bigeasy/stencil) [](https://coveralls.io/r/bigeasy/stencil)
Asynchronous HTML5 templating for Node.js and the browser. Photo by mufflevski.
Thoughts on Stencil? Join the
[Discussion](https://github.com/bigeasy/stencil/issues/11).
## Synopsis
Layouts.
```xml
<s:value select="attr.title"/>
```
Pages laid out.
```xml
Hello, World!
```
The same templates run on the browser and in Node.js, so you can use the same
logic you use to serve a generate page to refresh that page.
## Stencil on the Server
On the server, we create a template and serialize it to HTML5. You can also
serialize to older HTML flavors for older browsers.
## Stencil on the Browser
On the browser, when we generate Stencil XML, we simply import it into the
existing DOM using `Document.adoptNode`.
## Remember
* It's not a query tool. It's a templating tool.
## Expand
* Functions must have no side-effects; i.e. do not use your template functions
to create a hit counter.
* It's not hard to write template functions that do not have side effects. The
sort of functions that might have side effects are not likely to appear in
the logic that supports emitting markup.
## Motivations
Revisiting the ideas explored in a [Java based
Stencil](https://github.com/defunct/stencil).
Stencil is asynchronous HTML5 templating for Node.js and the browser. It based
on some ideas from yesteryear and some ideas from tomorrow.
This project evolved from work with Streamline and CoffeeScript. That work has
been moved to a project named [Pastiche](https://github.com/bigeasy/pastiche).
## Philosophy
Especially when dealing with a library that has a goal of being small, you're
limited as to how much scaffolding you can offer developers. My approach for
Stencil is to define three roles, application developer, web developer, and web
designer, and say the first two roles labor to create a childlike sense of
wonder in the latter role.
An application developer creates APIs that the web developer can query. The web
developer wraps those APIs in tag libraries, so that the web designer can focus
on semantic layout.
## Change log
Changes for each release.
### Version 0.0.5
Mon Apr 22 19:07:43 UTC 2013
* Fix non-directive with attribute child directives. #108.
### Version 0.0.4
Tue Apr 16 14:15:19 UTC 2013
* Add `request` and `response` to Stencil service. #106.
---
_Source: https://npm.io/package/stencil · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._