qingkuai

Qingkuai

Qingkuai is a compiler-based frontend framework for building web interfaces. It transforms .qk source files into minimal, strictly optimized JavaScript.

Learn more at Qingkuai Docs, or try it out in the Playground.

Why Qingkuai

• Architecture: Compile-time checking & performance optimization, fine-grained updates.
• Bundle Size: Runtime only 5KB–11KB (gzip), compiled size 20%–80% of other frameworks.
• Reactivity: Full reactive support with compiler-auto-inferred, no manual handling needed.
• Developer Experience: Native JS/TS-like experience inside script blocks, Try in Palyground.
• Debugging Experience: Enhanced debugging with source-matched and directive context identifiers.
• Language Services & AI: Full language services and mcp server for better AI-assisted development.

Quick Start

npm create qingkuai qingkuai-app
cd qingkuai-app
npm install && npm run dev

CLI

The official CLI (@qingkuai/cli) ships the whole toolchain — vite, TypeScript, Prettier (with prettier-plugin-qingkuai) and the Qingkuai language service are bundled at pinned versions and pre-wired into every command, so it works with zero configuration.

npm install -g @qingkuai/cli
qingkuai --help

Command	Description
qingkuai init [name]	Scaffold a new Qingkuai application (--ts for the TypeScript template)
qingkuai dev	Start the vite dev server with HMR
qingkuai build	Build a Qingkuai application or library into distributable files
qingkuai preview	Serve the build output directory via vite’s preview server
qingkuai check [files...]	Perform syntax or type checking (--types) on .qk and TypeScript files
qingkuai build-types [dir]	Type-check and emit declaration files (.d.ts)
qingkuai format [files...]	Format Qingkuai component files or other Prettier-supported files

Run qingkuai <command> --help for the full list of flags and examples, or see the CLI reference.

MCP Server

qingkuai-mcp-server equips AI agents with Qingkuai-aware tools: syntax documentation search, syntax checking, compilation, and code formatting for .qk files.

For example, add it to .vscode/mcp.json to use it with VS Code Copilot agent mode:

{
    "servers": {
        "qingkuai": {
            "type": "stdio",
            "command": "npx",
            "args": ["qingkuai-mcp-server@latest"]
        }
    }
}

It works with any MCP-compatible host (Claude Desktop, Cursor, etc.). See the package README for the full tool list and per-host configurations.

Js Framework Benchmark

Bundle Size Report

Contributing

Please see the Contributing Guide for details on how to contribute to QingKuai.

License

MIT © 2024-present, all contributors to qingkuai