@balikjs/mobile 0.0.1

package/README.md

@@ -0,0 +1,33 @@
+# @balikjs/mobile
+
+A mobile-first UI component library built on top of [Ark UI](https://ark-ui.com) for [Solid.js](https://solidjs.com).
+
+## Design Principles
+
+- **JavaScript only** — No TypeScript. Plain modern JavaScript with JSDoc for type hints.
+- **Modern JavaScript** — ES2020+ syntax. `const` / `let`, arrow functions, optional chaining, nullish coalescing, destructuring, template literals.
+- **ES Modules** — `type: "module"` in `package.json`. `import` / `export` everywhere. No CommonJS.
+- **Vite ecosystem** — Built with Vite, tested with Vitest.
+- **CSS Modules + tokens** — Styles authored with CSS Modules. Design tokens as CSS custom properties.
+
+## Install
+
+```bash
+npm install @balikjs/mobile solid-js @ark-ui/solid
+```
+
+## Usage
+
+```jsx
+import { Button, Toast, toast } from '@balikjs/mobile'
+import '@balikjs/mobile/styles.css'
+
+function App() {
+  return (
+    <>
+      <Toast />
+      <Button solid onClick={() => toast('Saved!')}>Click me</Button>
+    </>
+  )
+}
+```