New Research: Supply Chain Attack on Axios Pulls Malicious Dependency from npm.Details →
Socket
Book a DemoSign in
Socket

ds-one

Package Overview
Dependencies
Maintainers
1
Versions
67
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

ds-one

A component-based design system built with TypeScript and LitElement that provides reusable UI components with built-in theming, internationalization, and accessibility features.

latest
Source
npmnpm
Version
0.2.5-alpha.5
Version published
Maintainers
1
Created
Source

DS one

Build modern UIs with web components!

A component-based design system built with TypeScript and LitElement that provides reusable UI components with built-in theming, internationalization, and accessibility features.

npm version License: MIT

DS one is a modern design system that provides a comprehensive set of reusable UI components built with Web Components. Think "Material Design meets Web Standards"—a simple, accessible component library that works with any framework or vanilla JavaScript.

📦 Now available on NPM! Install with bun add ds-one@alpha and start building today.

🚀 Quick Start

Install

# Using bun (recommended)
bun add ds-one@alpha

# Using npm
npm install ds-one@alpha

# Using yarn
yarn add ds-one@alpha

Note: Currently published as alpha version 0.2.5-alpha.3. Use @alpha tag to install.

Basic Usage (CDN)

<!DOCTYPE html>
<html>
  <head>
    <!-- Load DS one CSS -->
    <link
      rel="stylesheet"
      href="https://cdn.jsdelivr.net/npm/ds-one@alpha/DS1/1-root/one.css"
    />
    <!-- Load DS one components -->
    <script type="module">
      import "https://cdn.jsdelivr.net/npm/ds-one@alpha/dist/ds-one.bundle.min.js";
    </script>
  </head>
  <body>
    <ds-button variant="primary">Get Started</ds-button>
    <ds-text key="welcome">Welcome to DS one</ds-text>
  </body>
</html>

Online demo

Try DS one in your browser: dsone.dev (documentation slugs to be decided)

✨ Features

Core Components

  • Web Components: Built with LitElement for maximum compatibility
  • TypeScript support: Full type definitions and IntelliSense
  • Accessibility: ARIA support and keyboard navigation built-in
  • Responsive design: Mobile-first with scaling factors
  • Theme system: CSS custom properties for easy customization

Internationalization

  • Language keys: All text via camelCase keys for full i18n
  • Notion CMS integration: Dynamic content management
  • Fallback support: Graceful degradation when translations missing
  • Multi-language: Built-in language switching

Developer Experience

  • Zero dependencies: Pure Web Components, no framework required
  • Fast loading: Optimized bundle size and tree-shaking
  • Hot reload: Live updates in development
  • Comprehensive testing: Full test coverage

Documentation

Current Status: v0.2.5-alpha.3

⚠️ Alpha Release: This is an early alpha version. The API may change as we refine the components and architecture.

Completed Features

  • ✅ Core component library (ds-button, ds-text, ds-icon, etc.)
  • ✅ Theming system with accent color support
  • ✅ Internationalization with language keys
  • ✅ Responsive design with mobile scaling
  • ✅ TypeScript definitions and type safety
  • ✅ Accessibility features and ARIA support
  • ✅ CDN delivery via jsDelivr
  • ✅ NPM package published

In Progress

  • 🚧 Component naming standardization (ds-* prefix)
  • 🚧 Enhanced theming documentation
  • 🚧 Component testing suite
  • 🚧 Documentation site refinement
  • 🚧 Additional component variants and states

Planned for Beta

  • 📋 Stable API and naming conventions
  • 📋 Comprehensive documentation with examples
  • 📋 Form components (input, select, checkbox, etc.)
  • 📋 Navigation components
  • 📋 Animation system
  • 📋 Design tokens documentation

Architecture

DS one/
├── DS1/
│   ├── 0-face/       # Device and language detection
│   ├── 1-root/       # Core styles, fonts, and design tokens
│   ├── 2-core/       # Core components (buttons, text, etc.)
│   ├── 3-unit/       # Composite components
│   ├── 4-page/       # Page-level components
│   ├── x-utils/      # Shared utilities (language, theme, etc.)
│   └── x-icon/       # SVG icon library
├── dist/             # Built files for NPM
├── examples/         # HTML examples
└── docs/             # Documentation

Roadmap

v0.2.0-beta (Target: Q2 2025)

  • Finalize component naming (ds-* prefix for all components)
  • Complete core component set
  • Enhanced theming system
  • Component testing suite
  • Comprehensive documentation

v0.5.0 (Target: Q3 2025)

  • Advanced components (forms, navigation, data display)
  • Animation system
  • Design tokens
  • Figma integration

v1.0.0 (Production - Target: Q4 2025)

  • Complete feature set
  • Production-ready tooling
  • Long-term API stability
  • Performance optimizations

Development Setup

# Clone the repository
git clone https://github.com/0001-labs/ds-one.git
cd ds-one

# Install dependencies
bun install

# Run tests
bun test

# Start development server
bun run dev

# Build components
bun run build

Release Process

# Create a new alpha release (recommended for now)
bun run release:pre:alpha  # Bumps alpha version (e.g., 0.2.5-alpha.3 → 0.2.5-alpha.3)

# Other release commands (for future use)
bun run release:patch      # For patch releases
bun run release:minor      # For minor releases
bun run release:major      # For major releases

License

MIT © DS one

  • Website - Official website (slugs to be decided)
  • GitHub - Source code and issues
  • NPM Package - Install with @alpha tag
  • CDN - Direct browser usage

DS one - Build modern UIs with web components that work everywhere.

Keywords

design-system

FAQs

Package last updated on 10 Dec 2025

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts