The goal of the project was to institute a easy way to build webapps.
Data-driven web framework for tiny webapps.
Lucia aims to
Lucia is a radical new approach to building user interfaces. Whereas traditional frameworks like React and Vue do the bulk of their work in the browser, Lucia shifts that work into a compile step that happens when you build your app.
Instead of using techniques like virtual DOM diffing, Lucia writes code that surgically updates the DOM when the state of your app changes.
Put this within your <head> tags in html.
<!-- development version, includes helpful console warnings -->
<script src="https://unpkg.com/lucia/dist/lucia.js"></script>
<!-- production version, optimized for size and speed -->
<script src="https://unpkg.com/lucia"></script>
Below is an example of a clicker game in Lucia.
<div id="app">
<button *on:click="increment()" *html="count"></button>
</div>
const ClickerGame = {
count: localStorage.count || 0,
increment() {
localStorage.count = ++this.count;
},
};
Lucia.createApp(ClickerGame).mount('#app');
At the core of Lucia is a system that enables us to declaratively render data to the DOM using the straightforward *html directive:
<div id="app">
<p *html="message"></p>
<p *html="message === 'Hello World!'"></p>
</div>
Lucia.createApp({
message: 'Hello World!',
}).mount('#app');
It’s easy to toggle the presence of an element, too:
<div id="app">
<button *if="!show">You can't see me</button>
<button *if="show">You can see me</button>
</div>
Lucia.createApp({
show: true,
}).mount('#app');
To let users interact with your app, we can use the *on directive to attach event listeners that invoke methods on our Lucia instances:
<div id="app">
<button *on:click="announce()" *html="message"></button>
</div>
Lucia.createApp({
message: 'Hello world!',
announce() {
alert(this.message);
},
}).mount('#app');
In addition to text interpolation, we can also bind element attributes like this:
<div id="app">
<h1 *bind:class="{ hello: show }">Classes are cool</h1>
<h1 *bind:style="color">Styles are sassy</h1>
</div>
Lucia.createApp({
show: true,
// You can also reference data vs inputing an object in the directive itself
color: { color: 'purple' },
}).mount('#app');
We can use the *join directive to render a list of items based on an array.
<div id="app">
<p *join="fruits by , "></p>
</div>
Lucia.createApp({
fruits: ['apple', 'orange', 'banana'],
}).mount('#app');
You can use the *model directive to create two-way data bindings on form input, textarea, and select elements.
<div id="app">
<input *model="message" />
<p *html="message"></p>
</div>
Lucia.createApp({
message: 'Nothing submitted yet',
}).mount('#app');
You can apply the callback to the mount method to read data values.
<div id="app">
<h1 *html="message"></h1>
</div>
Lucia.createApp({
message: 'Hello World',
}).mount('#app', ({ message }) => {
console.log(message); // => 'Hello World'
});
Lucia is MIT licensed.
FAQs
A simple and flexible authentication library
The npm package lucia receives a total of 22,359 weekly downloads. As such, lucia popularity was classified as popular.
We found that lucia demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Company News
Socket is joining TC54 to help develop standards for software supply chain security, contributing to the evolution of SBOMs, CycloneDX, and Package URL specifications.
Security News
PyPI now allows maintainers to archive projects, improving security and helping users make informed decisions about their dependencies.
Research
Security News
Malicious npm package postcss-optimizer delivers BeaverTail malware, targeting developer systems; similarities to past campaigns suggest a North Korean connection.