darky.app

What It Is

Darky.js is a small JavaScript library for frontend web pages, designed to help developers quickly add a dark mode toggle button to a site. According to the documentation examples, you can include the library via the JSDelivr CDN or npm, instantiate new Darky(), and call enable() to activate the dark mode component on the page.

Core Features and Developer Experience

Its functionality is focused on switching between light and dark themes on web pages. It supports enable() to activate the component, toggle() for manual switching, isEnabled() to check the current state, and an onChange callback for running custom logic when the mode changes. Configuration options cover button position, transition duration, background color, light/dark button colors, shadow, z-index, icon labels, and more. It also supports autoMatchOsTheme to follow the system theme, as well as saveInCookies to store user preferences.

Integration, Self-Hosting, and Ecosystem

Integration is fairly flexible: you can use the JSDelivr CDN, download the file for self-hosting, or install it via npm install darkyjs. It is more of a vanilla JavaScript utility; the crawled text does not show wrappers for React, Vue, Angular, or similar frameworks, nor does it mention TypeScript types, browser compatibility, or a plugin ecosystem. For static sites, documentation sites, and personal blogs, this lightweight dependency model can actually be quite straightforward.

Documentation Quality and Pricing

The documentation covers installation, options, methods, events, element ignore rules, and a changelog, which is enough for basic integration. It also notes that img, picture, and video are not converted by default, and that exceptions can be handled via darkmode--ignore, CSS isolation, or mix-blend-mode. However, the documentation contains an inconsistency between onChnge and onChange, and it does not provide information about the license, source code repository, commercial support, or pricing. As a result, its open-source status and service guarantees cannot be determined.

Pros, Cons, and Who It’s For

Its strengths are simplicity, light weight, support for CDN/NPM/self-hosting, and configuration that covers common UI needs. Its downsides are that its capabilities are narrow, it is not suitable for complex design systems or multi-theme management, and it lacks information about framework-level ecosystem support. It is best suited for frontend developers, small websites, and content sites that need to add dark mode quickly.

Access from China

The documentation mentions the JSDelivr CDN and NPM, but does not provide information about accessibility from mainland China. In real-world use, self-hosting may be worth considering to reduce CDN availability risks. Alternatives include darkmode-js, custom implementations based on CSS prefers-color-scheme, or built-in theme switching components in frontend frameworks.