chore: wip

Author: glennmichael123

packages/crosswind/README.md

@@ -0,0 +1,52 @@
+# @cwcss/crosswind
+
+A performant Utility-First CSS framework, similar to Tailwind or UnoCSS. Built with TypeScript and optimized for Bun.
+
+## Installation
+
+```bash
+bun add @cwcss/crosswind
+```
+
+```bash
+npm install @cwcss/crosswind
+```
+
+## Usage
+
+```typescript
+import { build, scan, generate } from '@cwcss/crosswind'
+
+// Build CSS from your content files
+const result = await build({
+  content: ['./src/**/*.html', './src/**/*.tsx'],
+  output: './dist/styles.css',
+  minify: true,
+})
+```
+
+### CLI
+
+```bash
+# Run the crosswind CLI
+crosswind build
+crosswind build --watch
+crosswind build --minify
+```
+
+## Features
+
+- On-demand utility CSS generation
+- Tailwind-compatible utility classes
+- Built-in CSS minification
+- File watching for development
+- Configurable theme (colors, spacing, typography, etc.)
+- Variant support (hover, focus, dark mode, responsive, and more)
+- Custom rules and shortcuts
+- Preset system for extensibility
+- Bun plugin support
+- Cross-platform CLI binaries (Linux, macOS, Windows)
+
+## License
+
+MIT

packages/headwind/README.md

@@ -0,0 +1,60 @@
+# headwind
+
+The core CSS engine powering the Crosswind framework. Headwind handles parsing, rule generation, scanning, and CSS output for utility-first CSS classes.
+
+## Installation
+
+```bash
+bun add headwind
+```
+
+```bash
+npm install headwind
+```
+
+## Usage
+
+```typescript
+import { build, buildAndWrite } from 'headwind'
+import { config } from 'headwind'
+
+// Build CSS from content patterns
+const result = await buildAndWrite({
+  ...config,
+  content: ['./src/**/*.html'],
+  output: './dist/styles.css',
+  minify: true,
+})
+
+console.log(`Generated ${result.classes.size} classes in ${result.duration}ms`)
+```
+
+### Using as a Bun Plugin
+
+```typescript
+import { plugin } from 'headwind'
+
+await Bun.build({
+  entrypoints: ['./src/index.ts'],
+  outdir: './dist',
+  plugins: [plugin()],
+})
+```
+
+## Features
+
+- Utility class parsing and CSS generation
+- Configurable theme (colors, spacing, fonts, breakpoints, etc.)
+- Variant support (responsive, hover, focus, dark mode, and many more)
+- Preflight / CSS reset styles
+- Custom rules and shortcuts
+- Preset system
+- Compile class transformer
+- Attributify mode
+- Bracket syntax support
+- File scanning and transformation
+- Bun plugin integration
+
+## License
+
+MIT

packages/vscode/README.md

@@ -0,0 +1,24 @@
+# crosswind-vscode
+
+A Visual Studio Code extension for the Crosswind CSS framework. Provides editor integration for an enhanced development experience.
+
+## Installation
+
+Install from the VS Code Marketplace by searching for **crosswind-vscode**, or install via the command line:
+
+```bash
+code --install-extension crosswind-vscode
+```
+
+## Usage
+
+Once installed, the extension activates automatically in projects using Crosswind. It provides utility class support directly in your editor.
+
+## Features
+
+- Crosswind utility class support within VS Code
+- Seamless integration with the Crosswind CSS framework
+
+## License
+
+MIT