Beta Release - This is a beta version. We welcome feedback and bug reports!
Part of the Cloudinary Developers organization.
Scaffold a Cloudinary React + Vite + TypeScript project with interactive setup.
- Node.js 18+ installed
- A Cloudinary account (free tier available)
- Sign up for free
- Your cloud name is in your dashboard
npx create-cloudinary-reactThe CLI will prompt you for:
- Project name
- Cloudinary cloud name (found in your dashboard)
- Upload preset (optional - required for uploads, but transformations work without it)
- AI coding assistant(s) you're using (Cursor, GitHub Copilot, Claude, etc.)
- Whether to install dependencies
- Whether to start dev server
- ✅ Interactive setup with validation
- ✅ Pre-configured Cloudinary React SDK
- ✅ TypeScript + Vite + React 19
- ✅ Typed Upload Widget component
- ✅ Environment variables with VITE_ prefix
- ✅ Multi-tool AI assistant support (Cursor, GitHub Copilot, Claude, and more)
- ✅ MCP configuration for Cloudinary integration
- ✅ ESLint + TypeScript configured
During setup, you'll be asked which AI coding assistant(s) you're using. The CLI will generate the appropriate configuration files:
- ✅ Cursor →
.cursorrules+.cursor/mcp.json(if selected) - ✅ GitHub Copilot →
.github/copilot-instructions.md - ✅ Claude Code / Claude Desktop →
.claude,claude.md+.cursor/mcp.json(if selected) - ✅ Generic AI tools →
AI_INSTRUCTIONS.md,PROMPT.md
MCP Configuration: The .cursor/mcp.json file is automatically generated if you select Cursor or Claude, as it works with both tools.
These rules help AI assistants understand Cloudinary React SDK patterns, common errors, and best practices. The generated app also includes an "AI Prompts" section with ready-to-use suggestions for your AI assistant.
This project uses Conventional Commits for version management and semantic-release for automated releases.
Releases are triggered manually via GitHub Actions workflow. The workflow uses npm trusted publishing (OIDC) for secure package publishing.
<type>(<scope>): <subject>
<body>
<footer>
Types:
feat: New featurefix: Bug fixdocs: Documentation changesrefactor: Code refactoringperf: Performance improvementschore: Other changes