@lanrenbang/basecoat-ultra-svelte 0.1.0 β†’ 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/LICENSE.md +21 -0
  2. package/README.md +136 -0
  3. package/package.json +1 -1
package/LICENSE.md ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Ronan Berder
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,136 @@
1
+ # Basecoat Ultra
2
+
3
+ [![Version](https://img.shields.io/npm/v/@lanrenbang/basecoat-ultra?style=flat-square)](https://www.npmjs.com/package/@lanrenbang/basecoat-ultra)
4
+ [![License](https://img.shields.io/github/license/hunvreus/basecoat?style=flat-square)](https://github.com/hunvreus/basecoat/blob/main/LICENSE.md)
5
+
6
+ **Basecoat Ultra** is a Tailwind-first UI component library designed for high performance, minimalism, and deep customization. Built upon the excellent foundation of [Basecoat](https://basecoatui.com) by [hunvreus](https://github.com/hunvreus), it brings the magic of shadcn/ui to any traditional web stack without requiring React.
7
+
8
+ 🎑 **[Live Demo & Documentation](https://lanrenbang.github.io/basecoat-ultra)**
9
+
10
+ ## ✨ Features
11
+
12
+ ### πŸ› οΈ Core Improvements Over Upstream
13
+ Enhanced from the original Basecoat with numerous optimizations and bug fixes:
14
+ - **CSS Modularization**: Refactored monolithic CSS into modular structure supporting on-demand loading
15
+ - **Tailwind v4 Compatibility**: Fixed escaping issues with complex selectors and modern CSS nesting
16
+ - **Component Optimizations**:
17
+ - Button: Fixed Ghost/Link variant background issues
18
+ - Dialog: Enhanced animations with natural scaling and bounce effects
19
+ - Dropdown Menu: Resolved initialization flickering
20
+ - Sidebar: Intelligent current page highlighting logic
21
+ - Form Elements: Improved contrast and accessibility
22
+
23
+ ### 🧩 New Components
24
+ Comprehensive component library inspired by shadcn/ui, completely framework-independent:
25
+ - **Standard Components**: Accordion, Sheet, Carousel, Input OTP, Toggle Group, Toggle
26
+ - **External Integrations**: Date Picker (Flatpickr), Resizable Panels (Split.js)
27
+ - **Advanced Features**: Command palette, enhanced dialogs, improved navigation
28
+
29
+ ### 🎨 Visual Enhancements
30
+ - **Catppuccin Themes**: Full suite support (Latte, FrappΓ©, Macchiato, Mocha) with theme switcher
31
+ - **Neumorphism Effects**: Global lighting system with mouse-following effects and 3D transforms
32
+ - **Enhanced Animations**: Smooth transitions and micro-interactions throughout
33
+
34
+ ### πŸ—οΈ Multi-Package Architecture
35
+ - **Ultra Package**: Framework-agnostic CSS/JS components for any stack
36
+ - **Svelte Package**: Native Svelte 5 components with Runes support
37
+ - **CLI Tool**: Copy-paste workflow for Svelte components
38
+ - **Documentation**: Comprehensive guides and interactive examples
39
+
40
+ ## πŸ“¦ Installation
41
+
42
+ Choose the package that fits your stack:
43
+
44
+ ### For Vanilla HTML/JS, React, Vue, or Other Frameworks
45
+ ```bash
46
+ bun add @lanrenbang/basecoat-ultra
47
+ # or npm install @lanrenbang/basecoat-ultra
48
+ ```
49
+
50
+ ### For Svelte 5 Projects
51
+ ```bash
52
+ # CLI approach (recommended)
53
+ npx basecoat-ultra-svelte@latest init
54
+ npx basecoat-ultra-svelte@latest add button
55
+
56
+ # Package approach
57
+ bun add @lanrenbang/basecoat-ultra-svelte
58
+ ```
59
+
60
+ ## πŸš€ Quick Setup
61
+
62
+ ### Bundler Setup (Vite, Webpack, etc.)
63
+ ```css
64
+ /* In your CSS file */
65
+ @import "tailwindcss";
66
+ @import "@lanrenbang/basecoat-ultra";
67
+ @import "@lanrenbang/basecoat-ultra/theme/catppuccin"; /* Optional */
68
+ ```
69
+
70
+ ```javascript
71
+ // In your JS file
72
+ import '@lanrenbang/basecoat-ultra/all';
73
+ ```
74
+
75
+ ### CDN Setup (No Build Tool)
76
+ ```html
77
+ <!-- CSS -->
78
+ <link href="https://cdn.jsdelivr.net/npm/@lanrenbang/basecoat-ultra@latest/dist/css/basecoat.cdn.min.css" rel="stylesheet">
79
+
80
+ <!-- JavaScript -->
81
+ <script src="https://cdn.jsdelivr.net/npm/@lanrenbang/basecoat-ultra@latest/dist/js/all.min.js" defer></script>
82
+ ```
83
+
84
+ For detailed setup instructions, configuration options, and usage examples, visit our **[comprehensive documentation](https://lanrenbang.github.io/basecoat-ultra)**.
85
+
86
+ ## πŸ› οΈ Development
87
+
88
+ This project uses a Bun workspace monorepo structure:
89
+
90
+ ```
91
+ packages/
92
+ β”œβ”€β”€ ultra/ # Core CSS/JS library (framework-agnostic)
93
+ β”œβ”€β”€ svelte/ # Svelte 5 components with Runes
94
+ β”œβ”€β”€ cli/ # CLI tool for Svelte components
95
+ └── docs/ # Documentation site (SvelteKit)
96
+ ```
97
+
98
+ ### Development Commands
99
+ ```bash
100
+ # Install dependencies
101
+ bun install
102
+
103
+ # Development servers
104
+ bun dev:ultra # Core Ultra package
105
+ bun dev:svelte # Svelte components
106
+ bun dev:docs # Documentation site
107
+
108
+ # Build packages
109
+ bun run build:ultra
110
+ bun run build:svelte
111
+ bun run build:docs
112
+
113
+ # CLI tool
114
+ bun cli # Run CLI locally
115
+ ```
116
+
117
+ ### Build Order
118
+ Due to package dependencies: Ultra β†’ Svelte β†’ Docs
119
+
120
+ ## ❀️ Credits
121
+
122
+ This project stands on the shoulders of giants:
123
+
124
+ - **[Basecoat](https://basecoatui.com)**: Original creator [hunvreus](https://github.com/hunvreus). Most foundational code belongs to the original author.
125
+ - **[Catppuccin](https://github.com/catppuccin/palette)**: Beautiful color palettes for theming
126
+ - **[Flatpickr](https://flatpickr.js.org/)** & **[Split.js](https://split.js.org/)**: Excellent third-party integrations
127
+ - **[puikinsh/login-forms](https://github.com/puikinsh/login-forms/tree/main/forms/neumorphism)**: Inspiration for neumorphism effects
128
+
129
+ ## β˜• Support
130
+
131
+ [![BuyMeACoffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/bobbynona) [![Ko-Fi](https://img.shields.io/badge/Ko--fi-F16061?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/bobbynona) [![USDT(TRC20)/Tether](https://img.shields.io/badge/Tether-168363?style=for-the-badge&logo=tether&logoColor=white)](https://github.com/Lanrenbang/.github/blob/5b06b0b2d0b8e4ce532c1c37c72115dd98d7d849/custom/USDT-TRC20.md) [![Litecoin](https://img.shields.io/badge/Litecoin-A6A9AA?style=for-the-badge&logo=litecoin&logoColor=white)](https://github.com/Lanrenbang/.github/blob/5b06b0b2d0b8e4ce532c1c37c72115dd98d7d849/custom/Litecoin.md)
132
+
133
+ ## πŸ“„ License
134
+
135
+ This project is licensed under the [MIT License](LICENSE.md).
136
+ Original Basecoat content copyright belongs to hunvreus.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lanrenbang/basecoat-ultra-svelte",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Svelte 5 components for Basecoat Ultra with Runes support.",
5
5
  "type": "module",
6
6
  "license": "MIT",