Can Framework

A modern, high-performance web framework designed for building reactive applications with Single File Components (.can). Can combines the simplicity of signal-based reactivity with a powerful CLI and a built-in compiler.

🚀 Features

• Signal-Based Reactivity: Fine-grained updates without a Virtual DOM.
• Single File Components: Write logic, templates, and scoped styles in .can files.
• Powerful CLI: Integrated tools for building, serving (HMR), and scaffolding.
• Static Site Generation (SSG): Pre-render your app for maximum SEO and speed.
• First-Class Tooling: Custom VS Code extension for syntax highlighting and snippets.
• Built-in Essentials: Store management, I18n, Animations, and Routing.

📦 Installation

Clone the repository and install dependencies:

npm install
npm run compile # Compiles the framework core and CLI

🛠️ CLI Usage

Once compiled, you can use the can command to manage your projects:

• Create a new project: can create <my-app>
• Start dev server (HMR): can dev
• Production build: can build
• Generate Static Site: can ssg

🧩 Component Example

component Counter {
    var count = signal(0);
    
    function increment() {
        this.count.value++;
    }

    var template = `
        <div class="box">
            <h1>Count: {{count}}</h1>
            <button @click="increment">Increment</button>
        </div>
    `;
}

<style scoped>
.box { padding: 20px; border-radius: 8px; }
</style>

🛠️ Internal Architecture

• /src/compiler: The core transpiler for .can files.
• /src/runtime-core: The base component class and DOM orchestration.
• /src/reactivity: The signal and effect engine.
• /ide-extension: Source for the VS Code extension.