wigify - GitLite

KO | EN

gitlite — search

#python #react #go #golang #machine-learning #rust #linux #java #windows #awesome #cli #kubernetes #vue #awesome-list

wigify

(★ 99)

Custom widgets for your desktop

파일 탐색기

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

- - release.yml
- FUNDING.yml
- icon.icns
- icon.png
- icon.svg
- features.md
- editor.png
- widgets.png
- brew-release.sh
- - main.ts
- - preload.ts
- - App.tsx
  - main.tsx
- - index.ts
- - electron.ts
  - index.ts
  - settings.ts
  - widget.ts
  - window.ts
- vite-env.d.ts
- - grid.test.ts
  - sample.test.ts
- - script.js
  - style.css
  - widget.html
- - script.js
  - style.css
  - widget.html
- - script.js
  - style.css
  - widget.html
- - script.js
  - style.css
  - widget.html
- - script.js
  - style.css
  - widget.html
- - script.js
  - style.css
  - widget.html
- - script.js
  - style.css
  - widget.html
- - script.js
  - style.css
  - widget.html
- - script.js
  - style.css
  - widget.html
- - script.js
  - style.css
  - widget.html
- - script.js
  - style.css
  - widget.html
- - script.js
  - style.css
  - widget.html
- - script.js
  - style.css
  - widget.html
- - script.js
  - style.css
  - widget.html
- - script.js
  - style.css
  - widget.html
.eslintrc.cjs
.gitignore
.prettierrc
AGENTS.md
bun.lock
CLAUDE.md
design.pen
electron-builder.json5
index.html
LICENSE
package.json
README.md
tsconfig.json
tsconfig.node.json
vite.config.mts
vitest.config.ts
widget.html

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/wigify/wigify

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

cd wigify

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

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

Homebrew macOS/Linux용 패키지 매니저입니다.

brew install wigify/tap/wigify

Homebrew로 이미 빌드된 패키지를 바로 설치합니다. 소스 빌드가 필요 없습니다.

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

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

3. Node.js

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

npm start

개발/실행 서버를 켭니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
  <img src="build/icon.png" alt="Wigify" width="128" height="128" />
</p>

<h1 align="center">Wigify</h1>

<p align="center">
  A desktop app that lets you create and display custom HTML/CSS/JS widgets right on your desktop.
</p>

<p align="center">
  <a href="https://github.com/wigify/wigify/releases">Download</a> · <a href="#installation">Installation</a> · <a href="#features">Features</a> · <a href="#contributing">Contributing</a> · <a href="#license">License</a>
</p>

---

## Installation

### Homebrew (macOS)

```bash
brew install wigify/tap/wigify
```

### Manual Download

Download the latest release from the [releases page](https://github.com/wigify/wigify/releases).

---

## Screenshots

<p align="center">
  <img src="./screenshots/widgets.png" alt="Widgets" width="600" />
</p>

## Features

- **Custom HTML Widgets** - Write widgets using plain HTML, CSS, and JavaScript. No framework required.
- **Built-in Code Editor** - Full-featured Monaco editor with syntax highlighting, autocompletion, and live preview.
- **Live Preview** - See your changes in real-time as you edit widget code.
- **Widget Templates** - Get started quickly with built-in templates: Stat, Weather, Chart, Visualizer, Countdown, Digital Clock, and more.
- **Auto-Refresh** - Set a refresh interval per widget (1s, 1m, 5m, 10m, 15m, 30m, 1h) to keep data up-to-date.
- **Cursor Dodge** - Widgets automatically fade out and become click-through when your cursor gets close.
- **Smart Grid Positioning** - Widgets are automatically arranged in a clean grid layout from the top-right corner.
- **Drag & Resize** - Move and resize widgets freely on your desktop. Positions are persisted across sessions.
- **System Tray** - Quick access to toggle auto-hide, arrange widgets, and manage the app from the menu bar.
- **Auto-Update** - Automatically checks for and installs updates from GitHub releases.
- **Dark & Light Theme** - Follows your system theme with a native glassy appearance on macOS.

## Built With

- [Electron](https://www.electronjs.org/) - Cross-platform desktop apps with JavaScript
- [React](https://react.dev/) - UI framework
- [TypeScript](https://www.typescriptlang.org/) - Type-safe JavaScript
- [Vite](https://vitejs.dev/) - Next-generation build tool
- [Tailwind CSS](https://tailwindcss.com/) - Utility-first CSS framework
- [Monaco Editor](https://microsoft.github.io/monaco-editor/) - The code editor that powers VS Code
- [Radix UI](https://www.radix-ui.com/) - Accessible UI primitives
- [cmdk](https://cmdk.paco.me/) - Command menu component
- [Lucide](https://lucide.dev/) - Icon library
- [electron-updater](https://www.electron.build/auto-update) - Auto-update for Electron apps
- [electron-builder](https://www.electron.build/) - Packaging and distribution
- [Vitest](https://vitest.dev/) - Unit testing framework

## Contributing

Contributions are welcome! Here's how you can help:

### Getting Started

1. Fork the repository
2. Clone your fork:

```bash
   git clone https://github.com/<your-username>/wigify.git
   cd wigify
   ```

3. Install dependencies:

```bash
   bun install
   ```

4. Start the dev server:

```bash
   bun dev
   ```

### Development

- **Lint** - `bun lint`
- **Test** - `bun test`
- **Format** - `bun format`
- **Type check** - `bun run typecheck`
- **Pre-commit check** - `bun pre-commit`

### Submitting Changes

1. Create a new branch for your feature or fix:

```bash
   git checkout -b my-feature
   ```

2. Make your changes
3. Run `bun pre-commit` to ensure lint, tests, and formatting all pass
4. Commit your changes with a clear message
5. Push to your fork and open a Pull Request

### Guidelines

- Follow the existing code style (Prettier handles formatting)
- Use Tailwind built-in classes only (no arbitrary values)
- Use `lucide-react` for icons
- Keep components small and reusable
- No code comments
- Write tests for new functionality when applicable

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.