{"id":13806860,"url":"https://github.com/celestia-island/hikari","last_synced_at":"2026-01-14T15:33:35.227Z","repository":{"id":94939247,"uuid":"588184956","full_name":"celestia-island/hikari","owner":"celestia-island","description":"The Frontend of Everything","archived":false,"fork":false,"pushed_at":"2026-01-08T19:57:20.000Z","size":2488,"stargazers_count":21,"open_issues_count":0,"forks_count":2,"subscribers_count":6,"default_branch":"master","last_synced_at":"2026-01-08T21:21:56.960Z","etag":null,"topics":["bbs","engine","forum","frontend","rust","website"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/celestia-island.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-01-12T14:26:16.000Z","updated_at":"2026-01-08T19:57:24.000Z","dependencies_parsed_at":"2023-05-07T09:47:44.113Z","dependency_job_id":"db3cf179-7404-4348-a11b-971fabd03d22","html_url":"https://github.com/celestia-island/hikari","commit_stats":null,"previous_names":["celestia-island/hikari"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/celestia-island/hikari","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celestia-island%2Fhikari","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celestia-island%2Fhikari/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celestia-island%2Fhikari/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celestia-island%2Fhikari/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/celestia-island","download_url":"https://codeload.github.com/celestia-island/hikari/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celestia-island%2Fhikari/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28424374,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T13:30:50.153Z","status":"ssl_error","status_checked_at":"2026-01-14T13:29:08.907Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bbs","engine","forum","frontend","rust","website"],"created_at":"2024-08-04T01:01:17.187Z","updated_at":"2026-01-14T15:33:35.220Z","avatar_url":"https://github.com/celestia-island.png","language":"Rust","funding_links":[],"categories":["Rust","Projects"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\u003cimg src=\"./website/res/icons/logo.png\" /\u003e\u003c/div\u003e\n\u003ch1 align=\"center\"\u003eHikari\u003c/h1\u003e\n\u003cdiv align=\"center\"\u003e\n \u003cstrong\u003e\n   The Frontend of Everything\n \u003c/strong\u003e\n\u003c/div\u003e\n\n\u003cbr /\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003c!-- CI status --\u003e\n  \u003ca href=\"https://github.com/celestia-island/hikari/actions\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/celestia-island/hikari/ci.yml?branch=main\"\n      alt=\"CI Status\" /\u003e\n  \u003c/a\u003e\n  \u003c!-- Built with --\u003e\n  \u003ca href=\"https://sagiegurari.github.io/cargo-make\"\u003e\n    \u003cimg src=\"https://sagiegurari.github.io/cargo-make/assets/badges/cargo-make.svg\" alt=\"Built with cargo-make\"\u003e\n  \u003c/a\u003e\n  \u003c!-- License --\u003e\n  \u003ca href=\"LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/License-MIT%20OR%20Apache--2.0-blue.svg\" alt=\"License: MIT OR Apache-2.0\"\u003e\n  \u003c/a\u003e\n  \u003c!-- Rust --\u003e\n  \u003ca href=\"https://www.rust-lang.org/\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/rust-1.52+-orange.svg\" alt=\"Rust 1.52+\"\u003e\n  \u003c/a\u003e\n  \u003c!-- Dioxus --\u003e\n  \u003ca href=\"https://dioxuslabs.com/\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/dioxus-0.7-blue.svg\" alt=\"Dioxus 0.7\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ch3\u003e\n    \u003ca href=\"https://celestia.world\"\u003e\n      Website\n    \u003c/a\u003e\n    \u003cspan\u003e | \u003c/span\u003e\n    \u003ca href=\"#quick-start\"\u003e\n      Quick Start\n    \u003c/a\u003e\n    \u003cspan\u003e | \u003c/span\u003e\n    \u003ca href=\"#examples\"\u003e\n      Examples\n    \u003c/a\u003e\n    \u003cspan\u003e | \u003c/span\u003e\n    \u003ca href=\"docs/ARCHITECTURE.md\"\u003e\n      Architecture\n    \u003c/a\u003e\n  \u003c/h3\u003e\n\u003c/div\u003e\n\n\u003cbr/\u003e\n\n\u003e A modern Rust UI framework blending traditional Chinese aesthetics with futuristic sci-fi design\n\n**Hikari** (光 - \"Light\") is a comprehensive UI framework built with [Dioxus](https://dioxuslabs.com/), featuring a unique design system inspired by Arknights' clean aesthetics, FUI (Futuristic User Interface) elements, and a rich palette of traditional Chinese colors. The name \"Hikari\" comes from the rhythm game [Arcaea](https://arcaea.lowiro.com/).\n\n## Vision\n\nHikari embodies three core design philosophies:\n\n- **Arknights Flat Design** - Clean lines, clear information hierarchy, high contrast, and refined simplicity\n- **FUI Sci-Fi Aesthetics** - Subtle glow effects, dynamic indicators, precise borders, and geometric patterns\n- **Chinese Traditional Colors** - 500+ authentic historical colors for cultural depth and visual richness\n\nThe result is a UI framework that feels both ancient and futuristic, professional yet approachable, with a distinctive visual identity that stands out from conventional component libraries.\n\n## Tech Stack\n\n- **Frontend**: Dioxus 0.7 (WebAssembly)\n- **Styling**: Grass (SCSS compiler) + SCSS\n- **Server**: Axum 0.8 (optional SSR support)\n- **Language**: Rust 1.52+\n- **Build System**: Justfile\n- **Tooling**: Python 3.11+ (formatting and linting)\n\n## Features\n\n### hikari-palette\n\n- 500+ traditional Chinese colors\n- Rich color metadata (hex, RGB, CMYK, historical notes)\n- Pre-defined palettes for different design systems\n- Type-safe color constants with Chinese names\n\n### hikari-theme\n\n- Theme context and provider\n- CSS variables system\n- Multiple built-in themes (Primary, FUI Dark, Arknights, Fresh)\n- SCSS mixins and utilities\n- Responsive design utilities\n\n### hikari-components\n\n- **Layout System**: Layout, Header, Aside, Content, Container, Grid, Row, Col, Section, Spacer\n- **Basic Components**: Button, Input, Card, Badge\n- **Feedback**: Alert, Toast, Tooltip\n- **Navigation**: Menu, Tabs, Breadcrumb\n- **Data Display**: Table (modular with pagination, sort, filter, selection)\n- **Data Display**: Tree (modular with virtual scroll, drag-drop, collapse)\n\n### hikari-extra-components\n\n- **Node Graph System**: Canvas, nodes, ports, connections, minimap, context menu\n- **Advanced Utilities**: Collapsible, DragLayer, ZoomControls\n- Perfect for visual editors, workflow builders, and data visualization\n\n### hikari-render-service\n\n- Server-Side Rendering support\n- Easy Axum integration\n- Static asset serving\n- Type-safe router builder\n- Production-ready error handling\n- Style service with CSS injection\n\n## Quick Start\n\n### Installation\n\nAdd Hikari to your `Cargo.toml`:\n\n```toml\n[dependencies]\nhikari-palette = \"0.1.0\"\nhikari-theme = \"0.1.0\"\nhikari-components = \"0.1.0\"\n```\n\n### Basic Usage\n\n```rust\nuse dioxus::prelude::*;\nuse hikari_theme::ThemeProvider;\nuse hikari_components::Button;\n\nfn app() -\u003e Element {\n    rsx! {\n        ThemeProvider { palette: \"arknights\".to_string(),\n            div { class: \"container\",\n                h1 { \"Welcome to Hikari\" }\n                p { \"A fusion of tradition and technology\" }\n\n                Button {\n                    variant: ButtonVariant::Primary,\n                    onclick: |_| println!(\"Clicked!\"),\n                    \"Get Started\"\n                }\n            }\n        }\n    }\n}\n```\n\n### With Chinese Colors\n\n```rust\nuse hikari_palette::{石青, 朱砂, 藤黄};\n\nfn customize_theme() {\n    let primary = 石青;\n    let secondary = 朱砂;\n    let accent = 藤黄;\n\n    println!(\"Primary: {} ({})\", primary.name, primary.hex);\n    // Output: Primary: 石青 (#1759A8)\n}\n```\n\n## Package Structure\n\n```\nhikari/\n├── packages/\n│   ├── hikari-palette/          # Chinese color system\n│   ├── hikari-theme/            # Theme system + SCSS\n│   ├── hikari-components/       # Basic components\n│   ├── hikari-extra-components/ # Advanced components\n│   └── hikari-render-service/   # SSR + style service\n│\n├── examples/\n│   ├── website/                 # Comprehensive website\n│   ├── table-demo/              # Table component demo\n│   ├── tree-demo/               # Tree component demo\n│   ├── node-graph-demo/         # Node graph demo\n│   └── ssr-demo/                # SSR example\n│\n├── docs/\n│   ├── ARCHITECTURE.md          # Architecture overview\n│   └── CONTRIBUTING.md          # Contributing guidelines\n│\n├── Cargo.toml                   # Workspace configuration\n├── PLAN.md                      # Implementation plan\n└── README.md                    # This file\n```\n\n## Examples\n\n### Layout Component\n\n```rust\nuse hikari_components::layout::{Layout, Header, Aside};\n\nrsx! {\n    Layout {\n        header: rsx! {\n            Header {\n                h1 { \"My Application\" }\n            }\n        },\n        aside: rsx! {\n            Aside {\n                nav {\n                    a { \"Home\" }\n                    a { \"About\" }\n                    a { \"Contact\" }\n                }\n            }\n        },\n        main {\n            p { \"Main content goes here...\" }\n        }\n    }\n}\n```\n\n### Button Component\n\n```rust\nrsx! {\n    Button {\n        variant: ButtonVariant::Primary,\n        size: ButtonSize::Large,\n        onclick: |_| println!(\"Clicked!\"),\n        \"Click Me\"\n    }\n\n    Button {\n        variant: ButtonVariant::Ghost,\n        icon: rsx! { Icon { name: \"search\" } },\n        \"Search\"\n    }\n\n    Button {\n        variant: ButtonVariant::Danger,\n        loading: true,\n        \"Processing...\"\n    }\n}\n```\n\n### Theme Provider\n\n```rust\nrsx! {\n    ThemeProvider {\n        palette: \"fui-dark\".to_string(),\n        // All components automatically use the FUI Dark theme\n        Button { \"FUI Button\" }\n    }\n}\n```\n\n### SSR Integration\n\n```rust\nuse hikari_render_service::HikariRenderServicePlugin;\n\n#[tokio::main]\nasync fn main() -\u003e anyhow::Result\u003c()\u003e {\n    let app = HikariRenderServicePlugin::new()\n        .add_route(\"/api/health\", health_handler)\n        .static_assets(\"./dist\")\n        .build()?;\n\n    let listener = tokio::net::TcpListener::bind(\"0.0.0.0:3000\").await?;\n    axum::serve(listener, app).await?;\n    Ok(())\n}\n```\n\n## Design Philosophy\n\n### Arknights Flat Design\n\n- Clean, sharp lines and edges\n- Clear information hierarchy\n- High contrast for readability\n- Minimalist without being boring\n\n### FUI Sci-Fi Aesthetics\n\n- Subtle glow effects (`box-shadow`, `text-shadow`)\n- Dynamic indicators (breathing lights, pulse animations)\n- Fine 1px semi-transparent borders\n- Geometric patterns (hexagons, grids)\n\n### Animation Principles\n\n- Subtle transitions (150ms ease)\n- Functional animations over decorative\n- Smooth, natural motion curves\n- No jarring or distracting effects\n\n### Chinese Color System\n\n- **Primary Colors**: Stone Cyan (石青), Cinnabar (朱砂), Vine Yellow (藤黄), Indigo (靛蓝)\n- **Neutral Colors**: Moon White (月白), Ink Black (墨色), Silk Gray (缟色)\n- **Functional Colors**: Scallion Green (葱倩 - success), Goosling Yellow (鹅黄 - warning), Cinnabar (朱砂 - danger)\n\nEach color carries historical significance, adding cultural depth to your applications.\n\n## Development\n\n### Prerequisites\n\n- Rust 1.52+\n- Python 3.11+ (for tooling scripts)\n- Just (command runner)\n\n### Build Commands\n\n```bash\n# Install just\ncargo install just\n\n# Build all packages\njust build\n\n# Run tests\njust test\n\n# Format code\njust fmt\n\n# Run linter\njust lint\n\n# Start development server\njust dev\n```\n\n### Package Status\n\n- [x] hikari-palette - Complete\n- [x] hikari-theme - Complete\n- [x] hikari-components - Basic components complete\n- [ ] hikari-extra-components - In progress\n- [x] hikari-render-service - Core features complete\n\nSee [PLAN.md](PLAN.md) for detailed implementation status.\n\n## Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](docs/CONTRIBUTING.md) for guidelines.\n\n## Documentation\n\n- [Architecture Overview](docs/ARCHITECTURE.md)\n- [Contributing Guidelines](docs/CONTRIBUTING.md)\n- [hikari-palette Documentation](packages/hikari-palette/README.md)\n- [hikari-theme Documentation](packages/hikari-theme/README.md)\n- [hikari-components Documentation](packages/hikari-components/README.md)\n- [hikari-extra-components Documentation](packages/hikari-extra-components/README.md)\n- [hikari-render-service Documentation](packages/hikari-render-service/README.md)\n\n## License\n\nHikari is dual-licensed under:\n\n- MIT License ([LICENSE-MIT](LICENSE-MIT) or \u003chttps://opensource.org/licenses/MIT\u003e)\n- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or \u003chttps://www.apache.org/licenses/LICENSE-2.0\u003e)\n\nYou may choose either license for your use.\n\n## Acknowledgments\n\nInspired by and built upon:\n\n- [Dioxus](https://dioxuslabs.com/) - The Rust UI framework\n- [Arknights](https://www.arknights.global/) - Design language inspiration\n- [ChineseColors](https://github.com/zhaoolee/ChineseColors) - Traditional color palette\n- [tairitsu](https://github.com/TairitsuMC/tairitsu) - Architecture patterns\n- [akasha](https://github.com/TairitsuMC/akasha) - Node graph system reference\n\n## Name\n\n\"Hikari\" (光) means \"light\" in Japanese, representing:\n\n- Illumination through knowledge and culture\n- The fusion of tradition (ancient wisdom) and technology (future innovation)\n- Bringing clarity and beauty to user interfaces\n\nLet Hikari illuminate your applications with the perfect blend of tradition and technology.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcelestia-island%2Fhikari","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcelestia-island%2Fhikari","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcelestia-island%2Fhikari/lists"}