Blinc - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #typescript #golang #deep-learning #linux #docker #kubernetes #awesome-list #security #openai #open-source

Blinc

(★ 514)

A declarative, reactive UI system with first-class state machines, spring physics animations, and GPU-accelerated rendering

파일 탐색기

최종 버전 다운로드 (.zip)

파일 수가 많아 일부만 표시됩니다. 전체 파일은 위 다운로드 버튼으로 확인해 주세요.

- config-fuchsia.toml
- config.toml
- - book-to-wiki.py
- - android.yml
  - ci.yml
  - coverage.yml
  - docs.yml
  - ios-compile.yml
  - msrv.yml
  - release.yml
- FUNDING.yml
- settings.json
- - Arial.ttf
  - FiraCode-Regular.ttf
  - JetBrainsMono-Regular.ttf
- - Cargo.toml
  - CHANGELOG.md
  - README.md
- - Cargo.toml
  - CHANGELOG.md
  - README.md
- - build.rs
  - Cargo.toml
  - README.md
- - Cargo.toml
  - CHANGELOG.md
  - README.md
- - Cargo.toml
- - Cargo.toml
  - CHANGELOG.md
  - README.md
- - Cargo.toml
  - COMPONENTS_NEEDED.md
  - README.md
- - Cargo.toml
  - ROADMAP.md
- - Cargo.toml
- - Cargo.toml
  - CHANGELOG.md
  - README.md
- - build.rs
  - Cargo.toml
  - README.md
- - Cargo.toml
  - CHANGELOG.md
  - README.md
- - Cargo.toml
  - CHANGELOG.md
  - README.md
- - Cargo.toml
  - README.md
- - Cargo.toml
  - CHANGELOG.md
- - Cargo.toml
  - README.md
- - Cargo.toml
- - Cargo.toml
  - README.md
- - Cargo.toml
  - CHANGELOG.md
  - README.md
- - Cargo.toml
  - README.md
- - Cargo.toml
  - CHANGELOG.md
- - Cargo.toml
  - README.md
- - Cargo.toml
  - CHANGELOG.md
  - README.md
- - Cargo.toml
  - README.md
.gitignore
backlog.md
blinc.toml
Cargo.toml
LICENSE
README.md
ROADMAP.md
Skills.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/project-blinc/Blinc

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd Blinc

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Rust

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Rust (rustup) rustup으로 설치하면 cargo도 함께 설치됩니다.

cargo run -p blinc_app_examples --example cn_demo --features cn

빌드 후 바로 실행까지 진행합니다.

✅ cargo build가 에러 없이 끝나면 성공입니다. target/ 폴더에 실행 파일이 생성됩니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Blinc

[![Build Status](https://github.com/project-blinc/Blinc/actions/workflows/ci.yml/badge.svg)](https://github.com/project-blinc/Blinc/actions/workflows/ci.yml)
[![Rust Version](https://img.shields.io/badge/rust-1.85%2B-blue.svg)](https://www.rust-lang.org)
[![Edition](https://img.shields.io/badge/edition-2024-blue.svg)](https://doc.rust-lang.org/edition-guide/rust-2024/)
[![Crates.io](https://img.shields.io/crates/v/blinc_app.svg)](https://crates.io/crates/blinc_app)
[![License](https://img.shields.io/badge/license-Apache--2.0-green.svg)](https://raw.githubusercontent.com/project-blinc/Blinc/main/LICENSE)
[![Blinc Book](https://img.shields.io/badge/Blinc_Book-blue.svg?logo=gitbook&logoColor=white)](https://project-blinc.github.io/Blinc)
[![Live Demos](https://img.shields.io/badge/Live_Demos-WebGPU-orange.svg)](https://project-blinc.github.io/Blinc/web/example-gallery.html)
[![Discord](https://img.shields.io/badge/Discord-Join-5865F2.svg?logo=discord&logoColor=white)](https://discord.gg/WXADUBBgzP)

![Blinc UI](https://raw.githubusercontent.com/project-blinc/Blinc/main/glass_music_player.png)

**A GPU-accelerated, cross-platform UI framework** for building desktop, mobile, and web applications from a single Rust codebase.

## Highlights

- **GPU-Accelerated**: SDF rendering, glassmorphism, spring physics, @flow custom shaders
- **Cross-Platform**: Desktop (macOS/Windows/Linux), Android, iOS, Web (WebGPU)
- **Builder API**: Declarative, chainable: `div().flex_col().gap(16.0).child(text("Hello"))`
- **40+ Components**: shadcn/ui-style library with CSS-overridable theming
- **40+ Live Demos**: [Try them in your browser](https://project-blinc.github.io/Blinc/web/example-gallery.html) (WebGPU required)

## Quick Start

```rust
use blinc_app::prelude::*;
use blinc_app::windowed::WindowedApp;

fn main() -> Result<()> {
    WindowedApp::run(WindowConfig::default(), |ctx| {
        div()
            .w(ctx.width).h(ctx.height)
            .bg(Color::rgb(0.1, 0.1, 0.15))
            .justify_center().items_center()
            .child(text("Hello Blinc!").size(48.0).color(Color::WHITE))
    })
}
```

The same `build_ui` function runs on desktop and web and no separate codebase.

## Running the examples

A fresh clone builds every example with no extra setup — the sibling crates
(`blinc_canvas_kit`, `blinc_portal_ui`, `blinc_node_editor`, `blinc_game_kit`)
resolve from their published git pins:

```bash
cargo run -p blinc_app_examples --example cn_demo --features cn
```

### Developing the sibling crates

Those four crates live in their own repositories. To edit them from local
checkouts, opt in with:

```bash
./scripts/use-local-packages.sh   # clones them into packages/ (gitignored)
                                  # and redirects the workspace to those copies
```

This modifies `Cargo.toml` **locally only** — do not commit it (CI's
`check-no-local-patch.sh` guard rejects it). Revert before committing:

```bash
./scripts/use-published-packages.sh
```

### Building on low-resource machines

The debug profile is tuned so a workspace build fits comfortably on ~8 GB
RAM / a small SSD: dependencies are compiled without debuginfo and
workspace crates use line-table backtraces only (`file:line` still
resolves). That is the single biggest lever for both `target/` size and
peak linker memory — no configuration needed.

If a full-workspace build still thrashes or OOMs on a constrained box
(e.g. an 8 GB ASUS NUC), reach for these, in order of impact:

- **Build only what you need**, not the whole workspace:
  `cargo run -p blinc_app_examples --example cn_demo --features cn`.
- **Cap parallelism** so N `rustc` processes don't collectively exhaust
  RAM: `CARGO_BUILD_JOBS=4 cargo build` (or uncomment `jobs` in
  `.cargo/config.toml`). Start near half your core count.
- **Use a faster, lower-memory linker** (mold on Linux, lld on macOS) —
  see the commented target blocks in `.cargo/config.toml`. Linking is the
  heaviest single step on low-RAM machines.
- **Reclaim SSD** with `CARGO_INCREMENTAL=0` (smaller `target/`, slower
  warm rebuilds), and `cargo clean` between large feature switches.

## Platform Support

| Platform | Status | Backend |
|----------|--------|---------|
| macOS | Stable | wgpu (Metal) |
| Windows | Stable | wgpu (DX12/Vulkan) |
| Linux | Stable | wgpu (Vulkan) |
| Android | Stable | wgpu (Vulkan) |
| iOS | Stable | wgpu (Metal) |
| **Web (WASM)** | **Preview** | wgpu (WebGPU) — Chrome 113+, Edge 113+, Firefox 141+, Safari 18+ (macOS Tahoe) |
| HarmonyOS | In progress | wgpu (Vulkan/OpenGL ES) |

## Documentation

**[Blinc Book](https://project-blinc.github.io/Blinc)**: comprehensive guide covering layout, styling, animation, widgets, routing, media, and more.

**[Live Example Gallery](https://project-blinc.github.io/Blinc/web/example-gallery.html)**: 40+ interactive WebGPU demos running in your browser.

**[API Reference](https://docs.rs/blinc_app)**: rustdoc for all crates.

**[Skills.md](Skills.md)**: concise, example-driven reference for AI code agents.

## Crates

| | Crate | Description |
|-|-------|-------------|
| **Core** | [blinc_app](crates/blinc_app) | App framework, windowed + web runners |
| | [blinc_core](crates/blinc_core) | Signals, state machines, types |
| | [blinc_layout](crates/blinc_layout) | Flexbox layout, element builders, widgets |
| | [blinc_gpu](crates/blinc_gpu) | SDF rendering, glass, shaders |
| **Rendering** | [blinc_text](crates/blinc_text) | Text shaping, glyph atlas |
| | [blinc_svg](crates/blinc_svg) | SVG parsing + rasterization |
| | [blinc_image](crates/blinc_image) | Image decoding, lazy loading |
| | [blinc_paint](crates/blinc_paint) | Canvas/paint API |
| **Animation** | [blinc_animation](crates/blinc_animation) | Springs, keyframes, timelines |
| | [blinc_theme](crates/blinc_theme) | Design tokens, light/dark mode |
| **Components** | [blinc_cn](crates/blinc_cn) | 40+ shadcn/ui-style components |
| | [blinc_icons](crates/blinc_icons) | Lucide icon set |
| **Platform** | [blinc_platform](crates/blinc_platform) | Cross-platform traits |
| | [blinc_platform_desktop](extensions/blinc_platform_desktop) | Desktop (winit) |
| | [blinc_platform_android](extensions/blinc_platform_android) | Android (NDK) |
| | [blinc_platform_ios](extensions/blinc_platform_ios) | iOS (UIKit/Metal) |
| | [blinc_platform_web](extensions/blinc_platform_web) | Web (WebGPU/WASM) |

## Roadmap

See [ROADMAP.md](ROADMAP.md) for detailed milestones. Current focus:

1. Missing widgets (date/time/color picker, data grid)
2. Zyntax DSL: `.blinc` domain specific language for UI definitions, with support for live editing and hot reload in the future
3. Accessibility (screen reader, keyboard navigation)
4. Developer tooling (hot reload, visual inspector)

## Community

Join us on **[Discord](https://discord.gg/WXADUBBgzP)**: questions, showcases, design discussion, and roadmap chatter. Also feel free to open a [GitHub Discussion](https://github.com/project-blinc/Blinc/discussions) for longer-form conversations.

## License

Apache License 2.0 - see [LICENSE](LICENSE)