English | 简体中文

Cova

The new standard for cover design

A professional-grade cover image generator with real-time preview, template management, and multi-format export — all running locally in your browser.

Features • Quick Start • Architecture • Contributing • Roadmap

Cova ships with a built-in AI assistant that keeps the local-first, privacy-friendly philosophy via a Bring-Your-Own-Key model — requests go directly from your browser to the OpenAI-compatible endpoint you configure (OpenAI, OpenRouter, Azure, local Ollama, …). Nothing passes through our servers.

• AI Design Copilot — Describe a cover from scratch, or iterate on what's already on the canvas. Cova sends your current design as context so the AI refines it instead of starting over.
• Quick Refine — One-tap chips ("More vivid", "Dark mode", "Bigger title", "Gradient", …) apply context-aware tweaks to the current design instantly.
• Wider control surface — AI can now drive typography (incl. italic), color, gradients, frosted-glass blur, radius and more.
• AI Copywriter — Turn a topic into punchy title/subtitle options, applied with one click.
• AI Palette — Generate a harmonious gradient + readable text color from a mood or keyword.
• Cancellable & robust — In-flight requests can be cancelled, with built-in timeout handling.
• Non-destructive — Every AI result can be reverted with a one-click Undo.
• Provider-agnostic — Any OpenAI-compatible Chat Completions endpoint works; your key is stored only in your browser.

# Clone the repository
git clone https://github.com/guizimo/cova.git

# Navigate to the project directory
cd cova

# Install dependencies
pnpm install

# Start the development server
pnpm dev

pnpm dev              # Start development server
pnpm build            # Build for production (tsc + vite)
pnpm preview          # Preview production build locally
pnpm lint             # Run ESLint
pnpm format           # Format code with Prettier
pnpm release          # Create a new release (standard-version)
pnpm release:major    # Major version bump
pnpm release:minor    # Minor version bump

Category	Technologies
Framework
Styling
Build
State	(with persist middleware)
i18n
Export

cova/
├── src/
│   ├── components/
│   │   ├── ui/                # Base UI components (Button, Input, Select, Slider, etc.)
│   │   ├── layout/            # Landing page sections (Navbar, Hero, Features, CTA, Footer)
│   │   └── generator/         # Editor components
│   │       ├── Header.tsx     # Editor header with version & GitHub stars
│   │       ├── Preview.tsx    # Real-time cover preview canvas
│   │       └── ConfigPanel/   # Configuration panels
│   │           ├── TitleConfig.tsx
│   │           ├── FontConfig.tsx
│   │           ├── BackgroundConfig.tsx
│   │           ├── IconConfig.tsx
│   │           ├── SizeConfig.tsx
│   │           └── TemplateConfig.tsx
│   ├── pages/                 # Route pages
│   │   ├── home/              # Landing page
│   │   ├── generator/         # Cover editor (core feature)
│   │   ├── features/          # Features showcase
│   │   ├── about/             # About page
│   │   ├── contact/           # Contact page
│   │   ├── faq/               # FAQ page
│   │   └── not-found/         # 404 page
│   ├── store/                 # Zustand stores (generator state + templates)
│   ├── config/                # App configuration constants
│   ├── types/                 # TypeScript type definitions
│   ├── utils/                 # Utility functions (export, i18n, share)
│   ├── lib/                   # Shared helpers (cn utility)
│   ├── locales/               # i18n translations (en.ts, zh.ts)
│   ├── styles/                # Global styles
│   └── router/                # React Router configuration
├── public/                    # Static assets
├── CHANGELOG.md               # Auto-generated changelog
└── package.json

We welcome contributions! Here's how you can help:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'feat: add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Submit a Pull Request

• v1.0.0 — Core cover generator with background, fonts, icons, and export
• v1.1.0 — Mobile optimization, enhanced UX, template system
• v1.2.0 — Template marketplace, real WebP export, high-resolution output, full i18n
• v1.3.0 — AI Native: AI design assistant, copywriter & palette (bring-your-own-key)
• v1.4.0 — AI Design Copilot: context-aware iterative refine, quick-refine actions, wider control surface, cancellable requests
• v1.5.0 — Collaboration features
• v2.0.0 — Plugin system, advanced animations and effects

If you find Cova helpful, please consider:

This project is licensed under the GPL-3.0 License — see the LICENSE file for details.