Nova UI Components

A modern, responsive design system built with React & TypeScript.
Nova UI includes reusable components like gradient backgrounds, responsive preference bubbles, and more — optimized for mobile and desktop.

📦 Installation & Usage

npm install nova-ui-components

import { Button, Card } from "nova-ui-components";

function App() {
  return (
    <div>
      <Button variant="primary" size="medium">
        Click me
      </Button>
      <Card>Content goes here</Card>
    </div>
  );
}

🔄 Package Updates

When you install or update the package, you might need to restart your dev server to pick up new TypeScript declarations.

# Update to latest version
npm update nova-ui-components

# Or install specific version
npm install [email protected]

After updating:

• Restart your dev server (npm run dev)
• Check for any breaking changes in the changelog

📦 Creating & Publishing Your Own Package to npm

Follow these steps to create your own component library and publish it to npm.

1. Create a New Project

mkdir nova-ui
cd nova-ui
npm init -y

2. Install Dependencies

npm install react react-dom
npm install --save-dev typescript @types/react @types/react-dom rollup @rollup/plugin-typescript @rollup/plugin-node-resolve @rollup/plugin-commonjs rollup-plugin-peer-deps-external @rollup/plugin-babel

3. Setup Build & Publish

# Build your components
npm run build

# Commit changes first
git add .
git commit -m "your changes"

# Version bump
npm version patch   # or minor/major

# Publish to npm
npm publish

🚀 Development Tips

Version Bumping Strategy

npm version patch   # 1.0.0 → 1.0.1 (Bug fixes, small tweaks)
npm version minor   # 1.0.0 → 1.1.0 (New features, new components)
npm version major   # 1.0.0 → 2.0.0 (Breaking changes, API changes)

When to Use Each Version Type

Patch (1.0.0 → 1.0.1):

• Fix component bugs
• Update component styling
• Fix TypeScript declarations
• Performance improvements
• Documentation updates

Minor (1.0.0 → 1.1.0):

• Add new components
• Add new props to existing components
• Add new features that don't break existing usage

Major (1.0.0 → 2.0.0):

• Remove or rename components
• Change required props
• Change component behavior in breaking ways
• Remove deprecated features

Common Publishing Issues

TypeScript Declaration Problems: If users can't import your components:

1. Make sure dist/index.d.ts exists after build
2. Check "types": "dist/index.d.ts" in package.json
3. Rebuild and republish with patch version

Git Working Directory Not Clean:

git add .
git commit -m "description of changes"
npm version patch

Build Failures:

• Check your rollup.config.js has both TypeScript and Babel plugins
• Make sure all imports are inside your src/ folder
• Verify tsconfig.json has "declaration": true