@discourser/design-system 0.1.0 → 0.1.3

package/README.md

@@ -1,7 +1,7 @@
-# @tastymakers/design-system
+# @discourser/design-system
 
 [![CI](https://github.com/tastymakers/design-system/actions/workflows/ci.yml/badge.svg)](https://github.com/tastymakers/design-system/actions/workflows/ci.yml)
-[![npm version](https://badge.fury.io/js/@tastymakers%2Fdesign-system.svg)](https://www.npmjs.com/package/@tastymakers/design-system)
+[![npm version](https://badge.fury.io/js/@discourser%2Fdesign-system.svg)](https://www.npmjs.com/package/@discourser/design-system)
 
 An aesthetic-agnostic design system built with Panda CSS and Ark UI. **Swap design languages by changing a single import.**
 
@@ -29,18 +29,18 @@ An aesthetic-agnostic design system built with Panda CSS and Ark UI. **Swap desi
 ## 📦 Installation
 
 ```bash
-npm install @tastymakers/design-system
+npm install @discourser/design-system
 # or
-pnpm add @tastymakers/design-system
+pnpm add @discourser/design-system
 # or
-yarn add @tastymakers/design-system
+yarn add @discourser/design-system
 ```
 
 ## 🎯 Quick Start
 
 ```tsx
-import { Button, Card, IconButton } from '@tastymakers/design-system';
-import '@tastymakers/design-system/styled-system';
+import { Button, Card, IconButton } from '@discourser/design-system';
+import '@discourser/design-system/styled-system';
 
 function App() {
   return (
@@ -65,7 +65,7 @@ function App() {
 Material Design 3 button with 5 variants and 3 sizes.
 
 ```tsx
-import { Button } from '@tastymakers/design-system';
+import { Button } from '@discourser/design-system';
 
 <Button variant="filled" size="md" leftIcon={<Icon />}>
   Click me
@@ -80,7 +80,7 @@ import { Button } from '@tastymakers/design-system';
 Container component with 3 variants and optional interactive state.
 
 ```tsx
-import { Card } from '@tastymakers/design-system';
+import { Card } from '@discourser/design-system';
 
 <Card variant="elevated" interactive>
   <h3>Card Title</h3>
@@ -96,7 +96,7 @@ import { Card } from '@tastymakers/design-system';
 Icon-only button with 4 variants and 3 sizes. Requires `aria-label` for accessibility.
 
 ```tsx
-import { IconButton } from '@tastymakers/design-system';
+import { IconButton } from '@discourser/design-system';
 
 <IconButton variant="filled" size="md" aria-label="Settings">
   <SettingsIcon />
@@ -179,7 +179,7 @@ pnpm test --ui     # Open Vitest UI
 
 | Command | Description |
 |---------|-------------|
-| `pnpm dev` | Start Storybook on port 6006 |
+| `pnpm dev` | Start Storybook on port 6006 
 | `pnpm build` | Build library (Panda + tsup) |
 | `pnpm build:panda` | Generate styled-system |
 | `pnpm build:lib` | Build library only |
@@ -191,16 +191,95 @@ pnpm test --ui     # Open Vitest UI
 
 ## 🤝 Contributing
 
-See [.github/README.md](.github/README.md) for CI/CD workflow documentation.
+### Development Workflow
 
-1. Fork the repository
-2. Create a feature branch: `git checkout -b feature/amazing-feature`
-3. Make your changes
-4. Run tests: `pnpm test --run`
-5. Run type check: `pnpm typecheck`
-6. Commit: `git commit -m 'Add amazing feature'`
-7. Push: `git push origin feature/amazing-feature`
-8. Open a Pull Request
+**⚠️ IMPORTANT: We use Changesets for version management. Never manually edit the version in `package.json`.**
+
+#### For Team Members (Write Access)
+
+1. **Create a feature branch from `main`:**
+   ```bash
+   git checkout main
+   git pull
+   git checkout -b feature/my-feature  # or fix/bug-name, docs/readme-update
+   ```
+
+2. **Make your changes and test:**
+   ```bash
+   pnpm test --run      # Run tests
+   pnpm typecheck       # Type check
+   pnpm lint            # Lint code
+   pnpm build           # Build package
+   ```
+
+3. **Create a changeset** (required for any code changes):
+   ```bash
+   pnpm changeset
+   # Select change type:
+   # - patch: Bug fixes (0.1.2 → 0.1.3)
+   # - minor: New features (0.1.2 → 0.2.0)
+   # - major: Breaking changes (0.1.2 → 1.0.0)
+   # Write a brief summary of your changes
+   ```
+
+4. **Commit and push:**
+   ```bash
+   git add .
+   git commit -m "feat: add amazing feature"
+   git push -u origin feature/my-feature
+   ```
+
+5. **Open a Pull Request to `main`:**
+   - CI will run automatically (lint, test, typecheck, build)
+   - Address any CI failures
+   - Wait for review (if required)
+
+6. **After your PR is merged:**
+   - Changesets bot creates/updates a "Version Packages" PR automatically
+   - When "Version Packages" PR is merged → package publishes to npm automatically via OIDC
+
+#### For External Contributors (No Write Access)
+
+1. **Fork the repository** on GitHub
+2. **Clone your fork:**
+   ```bash
+   git clone https://github.com/YOUR_USERNAME/Discourser-Design-System.git
+   ```
+
+3. **Follow steps 1-5 above** (feature branch, changeset, commit)
+4. **Open a Pull Request** from your fork to our `main` branch
+5. **Wait for maintainer review** - we'll review and merge if approved
+
+### Branch Protection
+
+- ✅ `main` is protected - all changes require Pull Requests
+- ✅ CI must pass before merging (lint, test, typecheck, build)
+- ✅ Only maintainers can merge to `main`
+- ✅ Releases only happen from `main` via automated workflow
+
+### Release Process (Automated)
+
+**You don't manually publish!** Our CI/CD handles it:
+
+1. **Changesets accumulate** - Multiple PRs can add changesets
+2. **"Version Packages" PR** - Created automatically when changesets exist
+3. **Review changelog** - Check the auto-generated CHANGELOG.md
+4. **Merge "Version Packages" PR** - Triggers automatic npm publish via OIDC
+5. **Published!** - Package is live on npm with provenance
+
+### What NOT to Do
+
+❌ Don't manually edit version in `package.json` - use `pnpm changeset`
+❌ Don't push directly to `main` - use Pull Requests
+❌ Don't merge without CI passing - wait for checks
+❌ Don't skip changesets - required for tracking changes
+❌ Don't manually run `npm publish` - CI handles it
+
+### Questions?
+
+- See [`.claude/skills/npm-oidc-publishing/SKILL.md`](.claude/skills/npm-oidc-publishing/SKILL.md) for OIDC setup details
+- See [.github/README.md](.github/README.md) for CI/CD workflow documentation
+- Ask in Discussions or open an Issue
 
 ## 📄 License
 
@@ -209,5 +288,5 @@ MIT © TastyMakers
 ## 🔗 Links
 
 - [Storybook Documentation](https://tastymakers.github.io/design-system/)
-- [npm Package](https://www.npmjs.com/package/@tastymakers/design-system)
+- [npm Package](https://www.npmjs.com/package/@discourser/design-system)
 - [GitHub Repository](https://github.com/tastymakers/design-system)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@discourser/design-system",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "Aesthetic-agnostic design system with Panda CSS and Ark UI",
   "type": "module",
   "publishConfig": {
@@ -66,7 +66,7 @@
     "typecheck": "tsc --noEmit",
     "changeset": "changeset",
     "version": "changeset version",
-    "release": "pnpm build && changeset publish"
+    "release": "pnpm build && changeset publish --access public"
   },
   "peerDependencies": {
     "react": ">=19.0.0",
@@ -79,6 +79,7 @@
   "devDependencies": {
     "@changesets/changelog-github": "^0.5.2",
     "@changesets/cli": "^2.29.8",
+    "@eslint/js": "^9.0.0",
     "@material/material-color-utilities": "^0.3.0",
     "@pandacss/dev": "^0.52.0",
     "@storybook/addon-a11y": "^8.5.0",
@@ -94,7 +95,11 @@
     "@vitejs/plugin-react": "^4.3.0",
     "@vitest/ui": "^2.1.9",
     "axe-core": "^4.11.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
     "eslint": "^9.0.0",
+    "eslint-plugin-react": "^7.35.0",
+    "eslint-plugin-react-hooks": "^5.0.0",
     "jest-axe": "^10.0.0",
     "jsdom": "^27.4.0",
     "prettier": "^3.3.1",
@@ -118,6 +123,6 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/tastymakers/Discourser-Design-System.git"
+    "url": "https://github.com/Tasty-Maker-Studio/Discourser-Design-System.git"
   }
 }