Skip to content

README.md

Latest commit

 

History

History
116 lines (72 loc) · 3.38 KB

README.md

File metadata and controls

116 lines (72 loc) · 3.38 KB

dev-widgets

Overview

Collection of useful developer utilities built as a pure Rust app on the Dioxus framework.

Available Widgets

Generators

  • UUID/GUID Generator - Generate unique identifiers
  • QR Code Generator - Generate QR codes from text
  • Hash Generator - Generate cryptographic hashes of strings
  • Password Generator - Generate secure, customizable passwords
  • Lorem Ipsum Generator - Generate placeholder text

Converters

  • Number Base Converter - Convert between binary, octal, decimal, and hexadecimal
  • JSON <> YAML Converter - Convert between JSON and YAML formats
  • Date Converter - Convert dates between formats

Encoders/Decoders

  • Base64 Encoder/Decoder - Encode and decode base64 strings
  • CIDR Decoder - Decode CIDR notation to IP address range

Media

  • Color Picker - Pick a color and get output in different formats

Development Setup

1. Install prerequisites

2. Install the Dioxus CLI

The easiest way to install the Dioxus CLI is via cargo-binstall:

cargo binstall dioxus-cli --force

If you don't have cargo-binstall, you can install it via:

cargo install cargo-binstall

3. Clone the repository

git clone https://github.com/esimkowitz/dev-widgets.git
cd dev-widgets

4. Install pnpm dependencies

pnpm is the package manager. The repo pins its version via the packageManager field in package.json and Corepack, so enable Corepack once and pnpm will pick up the right version automatically:

corepack enable
pnpm install

Web App

Build static site

Dev Widgets is hosted at https://widgets.fyi, automatically deployed from the main branch via GitHub Actions.

Run locally

pnpm serve:web

This compiles TailwindCSS with a file watcher and then starts the Dioxus dev server and runs the web app with hot-reloading enabled.

Build for release

This compiles the TailwindCSS and builds the web app as a single-page app for release to static hosting like GitHub Pages.

pnpm build:web

Desktop App

Dev Widgets also runs as a native desktop app via Tauri. Validated on macOS and Windows.

Run desktop app locally

pnpm serve:desktop

This compiles TailwindCSS with a file watcher and then starts the Dioxus dev server and runs the desktop app with hot-reloading enabled.

Bundle app

This compiles the TailwindCSS and builds the desktop app for release.

pnpm build:desktop

Roadmap

This app is heavily inspired by DevToys and DevToysMac and my roadmap for widgets I plan to support will align with these projects.

I will be tracking new development in the dev-widgets project board. New widgets will be organized under the "Widgets" area, and all other development will be tracked under the "Platform" area.