# Incarnative.js

> Incarnative.js (inca) is an ultra-lightweight, Webview-free desktop application framework powered by GPUI, QuickJS, and custom renderers.

An ultra-lightweight desktop framework powered by GPUI, QuickJS, and custom renderers.

## Table of Contents

### Introduction

- [How it Works](https://incajs.tom96da.com/guide/how-it-works.md): The pipeline inca runs, from your .vue source to pixels on screen, and why it's built that way.
- [Getting Started](https://incajs.tom96da.com/guide.md): Get up and running with Incarnative.js. Learn how to install, write, and run your app.

### Guide

- [Hot Module Replacement ](https://incajs.tom96da.com/guide/hmr.md): Hot module replacement under inca dev --experimental-hmr — how to enable it, what it does differently, and its known limitations.
- [Application Window](https://incajs.tom96da.com/guide/window.md): The window an inca app opens in — its size, its title, its menu, and how it closes.
- [Building for Production](https://incajs.tom96da.com/guide/build.md): Bundle an Incarnative.js app for production and package it into a distributable application.
- [Troubleshooting](https://incajs.tom96da.com/guide/troubleshooting.md): Common problems when running an Incarnative.js app, and where to look.

### Reference

- [Command Line Interface](https://incajs.tom96da.com/reference/cli.md): Reference of the inca CLI commands — dev, build, and package.
- [Configuration](https://incajs.tom96da.com/reference/configuration.md): Every key inca.config.ts takes, its type, and what it defaults to.
- [Elements & Styles](https://incajs.tom96da.com/reference/elements.md): Every style key Incarnative.js renders, how elements and `class` work, and which Vue features this renderer doesn't support yet.
- [Events](https://incajs.tom96da.com/reference/events.md): Every event name Incarnative.js dispatches, the fields it carries, and how propagation and focus work.
- [Console ](https://incajs.tom96da.com/reference/console.md): The console methods Incarnative.js provides, format specifiers, output and colour, and where printing differs from Node.
- [Error Codes](https://incajs.tom96da.com/reference/errors.md): Every ERR_INCA_* code the inca CLI reports, what causes it, and how to resolve it.

### Other

- [Roadmap](https://incajs.tom96da.com/roadmap.md): What's shipped, in progress, and planned for inca, phase by phase.