iares
v1.2.5
Published
A reactive library javascript and typescript to build SPA
Downloads
192
Readme
IARES is a javascript micro-library, written in typescript. Despite being extremely small (300 lines) it is perfectly capable and allows building SPA applications quickly and uncomplicated.
With IARES you won't waste hours and hours reading documentation. Read once, use forever!
IARES was created taking into account DRY, KISS and YAGNI. Therefore, it is designed to help drive real value in delivering software products and solutions.
No more wasting time, see how to use IARES below.
Install
Para instalar IARES em um novo projeto:
npm install iares
Para iniciar a partir de um template:
npx degit github:to-codando/iares-template my-new-project
Component
A component in IARES is just a factory function that can receive properties with a parameter and that returns an object containing the component's resources.
import { createState, html, css } from 'iares'
import {ComponentType, TemplateType} from './types'
const styles = () => css`
.title-ctx { color: blue }
`
const template: TemplateType = ({ state, props }) => html`
<h1 class="title-ctx">Hello ${props.word} ${state.word}!</h1>
`
export HelloApp: ComponentType = ({ props }) => {
const store = createState({ word: 'world'})
return {
styles,
template
}
}
And to create the application and render the component:
import { html, createApp, render } from 'iares'
import { HelloApp } from './components/HelloApp'
export const appHost = createApp({
onMount: (body: HTMLElement) => {
render(html`<${HelloApp} word="beaultiful" />`, body)
}
})
In the index.html file that loads the application bundle:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Hello IARES</title>
</head>
<body>
<script src="main.js" type="module"></script>
<script type="module">
import { appHost } from './main.js'
appHost.mount()
</script>
</body>
</html>
If you started with the default template described above, just run the code below in the project directory in the terminal to see the result of the configurations created so far.
pnpm start
That's it for now.
IARES is under development and I'm focused on creating the documentation right now.
I intend to publish the rest of the documentation soon.