dap-design-system 0.42.0 → 0.43.0

package/README.md

@@ -35,6 +35,42 @@ Start using the components in your application:
 
 That's it! You're now ready to start building beautiful web applications with the DÁP Design System Component Library.
 
+## Importing Components
+
+The design system supports multiple import strategies for optimal bundle sizes:
+
+### Tree-Shakeable Imports (Recommended)
+
+Import only the components you need to minimize bundle size:
+
+```javascript
+// Import components (excludes icons - saves ~130KB)
+import { DapDSButton, DapDSInput } from 'dap-design-system/components'
+
+// Import icons separately when needed (excludes components - saves ~1MB)
+import { SystemAddLine, ArrowsArrowDownLine } from 'dap-design-system/icons'
+
+// Import React wrappers
+import { DapDSButton } from 'dap-design-system/react'
+```
+
+### Full Bundle Import (Backward Compatible)
+
+Import everything (components + icons):
+
+```javascript
+// Imports all components and icons (~1.1MB total)
+import { DapDSButton, SystemAddLine } from 'dap-design-system'
+```
+
+**Bundle Sizes:**
+- **Main entry**: ~9KB (re-exports components and icons)
+- **Components**: ~1MB (all components without icons)
+- **Icons**: ~130KB (all icons without components)
+- **React wrappers**: ~38KB
+
+Using the tree-shakeable imports (`/components` and `/icons`) allows modern bundlers to optimize your final bundle size based on what you actually use.
+
 ## Benefits of web components
 
 Web components are a set of web platform APIs that allow you to create new custom, reusable, encapsulated HTML tags to use in web pages and web apps. Custom components and widgets build on the Web Component standards, will work across modern browsers, and can be used with any JavaScript library or framework that works with HTML.