docs: add documentation site with Docus and Cloudflare Pages

Set up docs/ directory with Docus (Nuxt-based documentation theme)
covering eslint-config, prettier-config, and editorconfig packages.
Configured for Cloudflare Pages static deployment via wrangler.

Author: amondnet

bun.lock

@@ -0,0 +1,15 @@
+# Nuxt
+.nuxt/
+.output/
+.data/
+dist/
+
+# Node
+node_modules/
+
+# Cloudflare
+.wrangler/
+
+# Misc
+.DS_Store
+*.log

docs/.gitignore

@@ -0,0 +1,21 @@
+export default defineAppConfig({
+  docus: {
+    locale: 'en',
+  },
+  seo: {
+    title: 'PleaseAI Code Style',
+    description: 'Shared code style configurations for PleaseAI projects',
+    titleTemplate: '%s - PleaseAI Code Style',
+  },
+  header: {
+    title: 'PleaseAI Code Style',
+  },
+  toc: {
+    title: 'On this page',
+  },
+  github: {
+    url: 'https://github.com/pleaseai/code-style',
+    branch: 'main',
+    rootDir: 'docs',
+  },
+})

docs/app/app.config.ts

@@ -0,0 +1,100 @@
+---
+title: ESLint Config
+description: Opinionated ESLint flat config for PleaseAI projects.
+navigation:
+  icon: i-lucide-shield-check
+---
+
+# ESLint Config
+
+`@pleaseai/eslint-config` is an opinionated ESLint flat config built on top of [`@antfu/eslint-config`](https://github.com/antfu/eslint-config).
+
+## Features
+
+- ESLint flat config format
+- Single quotes, no semicolons, 2-space indent
+- TypeScript support out of the box
+- Auto-detects `.gitignore` patterns
+- Re-exports all `@antfu/eslint-config` utilities
+
+## Installation
+
+:::code-group
+```bash [bun]
+bun add -D @pleaseai/eslint-config eslint
+```
+
+```bash [pnpm]
+pnpm add -D @pleaseai/eslint-config eslint
+```
+
+```bash [npm]
+npm install -D @pleaseai/eslint-config eslint
+```
+:::
+
+## Usage
+
+Create an `eslint.config.ts` (or `eslint.config.mjs`) in your project root:
+
+```ts [eslint.config.ts]
+import pleaseai from '@pleaseai/eslint-config'
+
+export default pleaseai()
+```
+
+### With Options
+
+The `pleaseai()` function accepts the same options as `@antfu/eslint-config`:
+
+```ts [eslint.config.ts]
+import pleaseai from '@pleaseai/eslint-config'
+
+export default pleaseai({
+  vue: true,
+  react: true,
+  // Override any @antfu/eslint-config option
+})
+```
+
+### With Additional Configs
+
+You can pass additional flat config items as rest arguments:
+
+```ts [eslint.config.ts]
+import pleaseai from '@pleaseai/eslint-config'
+
+export default pleaseai(
+  {
+    typescript: true,
+  },
+  {
+    rules: {
+      'no-console': 'warn',
+    },
+  },
+)
+```
+
+## Defaults
+
+| Option | Value |
+|--------|-------|
+| `indent` | `2` (spaces) |
+| `quotes` | `single` |
+| `semi` | `false` |
+| `typescript` | `true` |
+| `gitignore` | `true` |
+
+## VS Code Integration
+
+Install the [ESLint extension](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) and add to your `.vscode/settings.json`:
+
+```json [.vscode/settings.json]
+{
+  "eslint.format.enable": true,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit"
+  }
+}
+```

docs/bun.lock

@@ -0,0 +1,38 @@
+---
+title: Package JSON Lint
+description: Lint package.json files with ESLint.
+---
+
+# Package JSON Lint
+
+`@pleaseai/eslint-config` also exports configs from [`eslint-plugin-package-json`](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json) for linting `package.json` files.
+
+## Usage
+
+```ts [eslint.config.ts]
+import { recommended, stylistic } from '@pleaseai/eslint-config/package-json'
+
+export default [
+  recommended,
+  stylistic,
+]
+```
+
+### Available Configs
+
+| Export | Description |
+|--------|-------------|
+| `recommended` | Recommended rules for publishable packages |
+| `stylistic` | Stylistic rules for consistent `package.json` formatting |
+
+### Combined with ESLint Config
+
+```ts [eslint.config.ts]
+import pleaseai from '@pleaseai/eslint-config'
+import { recommended } from '@pleaseai/eslint-config/package-json'
+
+export default pleaseai(
+  {},
+  recommended,
+)
+```

docs/content/1.eslint-config/1.index.md

@@ -0,0 +1,74 @@
+---
+title: Prettier Config
+description: Shared Prettier configuration for PleaseAI projects.
+navigation:
+  icon: i-lucide-paintbrush
+---
+
+# Prettier Config
+
+`@pleaseai/prettier-config` provides a shared Prettier configuration for consistent formatting across PleaseAI projects.
+
+## Installation
+
+:::code-group
+```bash [bun]
+bun add -D @pleaseai/prettier-config prettier
+```
+
+```bash [pnpm]
+pnpm add -D @pleaseai/prettier-config prettier
+```
+
+```bash [npm]
+npm install -D @pleaseai/prettier-config prettier
+```
+:::
+
+## Usage
+
+Reference it in your `package.json`:
+
+```json [package.json]
+{
+  "prettier": "@pleaseai/prettier-config"
+}
+```
+
+Or create a `.prettierrc.json`:
+
+```json [.prettierrc.json]
+"@pleaseai/prettier-config"
+```
+
+### Extending
+
+To override specific options, create a `.prettierrc.mjs`:
+
+```js [.prettierrc.mjs]
+import config from '@pleaseai/prettier-config'
+
+export default {
+  ...config,
+  printWidth: 100,
+}
+```
+
+## Configuration
+
+| Option | Value |
+|--------|-------|
+| `singleQuote` | `true` |
+| `semi` | `false` |
+| `useTabs` | `false` |
+| `tabWidth` | `2` |
+| `endOfLine` | `auto` |
+| `bracketSpacing` | `false` |
+| `arrowParens` | `always` |
+| `bracketSameLine` | `false` |
+| `printWidth` | `120` |
+| `trailingComma` | `all` |
+
+## Compatibility
+
+- Prettier `^2.8.8` or `^3.0.0`

docs/content/1.eslint-config/2.package-json.md

@@ -0,0 +1,25 @@
+---
+title: EditorConfig
+description: Shared EditorConfig for consistent editor settings.
+navigation:
+  icon: i-lucide-file-cog
+---
+
+# EditorConfig
+
+`@pleaseai/editorconfig` provides a shared `.editorconfig` file for consistent editor settings across PleaseAI projects.
+
+## What is EditorConfig?
+
+[EditorConfig](https://editorconfig.org/) helps maintain consistent coding styles across different editors and IDEs. Most modern editors support it natively or via plugins.
+
+## Usage
+
+Copy the `.editorconfig` file from this package to your project root, or reference the package in your project setup scripts.
+
+## Supported Editors
+
+- VS Code (built-in or via [EditorConfig extension](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig))
+- JetBrains IDEs (built-in)
+- Vim/Neovim (via plugin)
+- Sublime Text (via plugin)

docs/content/2.prettier-config.md

@@ -0,0 +1,47 @@
+---
+title: PleaseAI Code Style
+description: Shared code style configurations for PleaseAI projects.
+navigation: false
+---
+
+# PleaseAI Code Style
+
+Shared ESLint, Prettier, and EditorConfig configurations for consistent code style across PleaseAI projects.
+
+## Packages
+
+::card-group
+  ::card{title="ESLint Config" icon="i-lucide-shield-check" to="/eslint-config"}
+  Opinionated ESLint flat config built on top of `@antfu/eslint-config`.
+  ::
+
+  ::card{title="Prettier Config" icon="i-lucide-paintbrush" to="/prettier-config"}
+  Shared Prettier configuration for consistent formatting.
+  ::
+
+  ::card{title="EditorConfig" icon="i-lucide-file-cog" to="/editorconfig"}
+  Shared `.editorconfig` for consistent editor settings.
+  ::
+::
+
+## Quick Start
+
+:::code-group
+```bash [bun]
+bun add -D @pleaseai/eslint-config eslint
+```
+
+```bash [pnpm]
+pnpm add -D @pleaseai/eslint-config eslint
+```
+
+```bash [npm]
+npm install -D @pleaseai/eslint-config eslint
+```
+:::
+
+```ts [eslint.config.ts]
+import pleaseai from '@pleaseai/eslint-config'
+
+export default pleaseai()
+```

docs/content/3.editorconfig.md

@@ -0,0 +1,3 @@
+export default defineNuxtConfig({
+  extends: ['docus'],
+})