docs: readme

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,83 @@
+name: Bug report
+description: Report an issue with uniwind
+labels: Needs review
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ## Required Information
+
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: Provide a clear, concise, and descriptive explanation of the bug. Include screenshots or a video if needed by dragging and dropping them into the box below.
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: Provide a detailed list of steps to reproduce the issue.
+      placeholder: |
+        1.
+        2.
+        3.
+    validations:
+      required: true
+
+  - type: input
+    id: repro
+    attributes:
+      label: Snack or Repository Link (Optional)
+      description: Provide a link to a GitHub repository or Snack that reproduces the issue.
+      placeholder: Issues without a reproduction may be marked as stale.
+
+  - type: input
+    id: uniwind-version
+    attributes:
+      label: Uniwind Version
+      description: Which version of `uniwind` are you using?
+      placeholder: 1.0.0
+    validations:
+      required: true
+
+  - type: input
+    id: react-native-version
+    attributes:
+      label: React Native Version
+      description: Which version of React Native are you using?
+      placeholder: 0.78.0
+    validations:
+      required: true
+
+  - type: dropdown
+    id: platforms
+    attributes:
+      label: Platforms
+      description: Which platforms does the issue occur on? (Select all that apply.)
+      multiple: true
+      options:
+        - Android
+        - iOS
+        - Web
+    validations:
+      required: true
+
+  - type: dropdown
+    id: expo
+    attributes:
+      label: Expo
+      description: Are you using Expo?
+      options:
+        - 'Yes'
+        - 'No'
+
+  - type: checkboxes
+    attributes:
+        label: Additional information
+        description: Please check all the boxes that apply
+        options:
+          - label: I've searched for [similar issues in this repository](https://github.com/Unistyles-OSS/uniwind/issues) and found none
+            required: true

LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 Uniwind
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

packages/uniwind/package.json

@@ -3,7 +3,7 @@
     "name": "uniwind",
     "version": "1.0.0-beta.5",
     "description": "The fastest Tailwind bindings for React Native",
-    "homepage": "https://github.com/Unistyles-OSS/uniwind",
+    "homepage": "https://uniwind.dev",
     "author": "UnistylesOSS",
     "type": "module",
     "repository": "https://github.com/Unistyles-OSS/uniwind",
@@ -19,6 +19,18 @@
         "build:css": "bun run src/css/index.ts",
         "test": "bun test"
     },
+    "keywords": [
+        "unistyles",
+        "react-native-unistyles",
+        "react-native",
+        "react",
+        "native",
+        "tailwind",
+        "tailwindcss",
+        "theme",
+        "style"
+    ],
+    "license": "MIT",
     "style": "./uniwind.css",
     "source": "src/index",
     "exports": {

readme.md

@@ -1,6 +1,45 @@
-# uniwind
+[<img alt="uniwind" src="assets/banner.png">](https://uniwind.dev/)
 
-```bash
-bun install
-bun run build
+<div align="center">
+    <p align="center">
+        <a href="https://uniwind.dev/" target="_blank">
+            <h1 align="center" style="color:red;">Uniwind</h1>
+            <span>The fastest Tailwind bindings for React Native</span>
+        </a>
+    </p>
+</div>
+<br />
+
+![npm version](https://img.shields.io/npm/v/uniwind?style=for-the-badge)
+[![npm downloads](https://img.shields.io/npm/dm/uniwind?style=for-the-badge)](https://www.npmjs.com/package/uniwind)
+[![npm downloads](https://img.shields.io/npm/dt/uniwind?style=for-the-badge)](https://www.npmjs.com/package/uniwind)
+[![License: MIT](https://img.shields.io/badge/License-MIT-44CD11.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
+
+## Installation
+
+```sh
+bun install uniwind@beta tailwindcss
 ```
+
+Then follow [installation guides](https://docs.uniwind.dev/quickstart)
+
+## Documentation
+
+- [Start here](https://docs.uniwind.dev/)
+- [Theming Basics](https://docs.uniwind.dev/theming/basics)
+- [Supported classNames](https://docs.uniwind.dev/class-names)
+- [Pro Version](https://docs.uniwind.dev/pro-version)
+
+## Features
+
+- ⚛️ Out‑of‑the‑box `className` bindings for every React Native component  
+- ⚡ Styles are computed at build time for maximum performance  
+- 🌙 Dark mode and 🎨 fully customizable themes
+- 🧩 Pseudo‑classes support — `focus`, `active`, `disabled`, and more
+- 📱 Responsive design with media queries
+- 🧰 Use custom CSS properties directly in React Native
+- 🔥 And [much more](https://docs.uniwind.dev/api/use-uniwind)
+
+## License
+
+MIT