{"id":24378715,"url":"https://github.com/vertocode/cloudmerce","last_synced_at":"2025-12-26T16:49:56.412Z","repository":{"id":271799635,"uuid":"877014573","full_name":"vertocode/cloudmerce","owner":"vertocode","description":"Cloudmerce is a full-featured e-commerce system that lets you run multiple online stores from a single codebase. Think of it as your own customizable shopping platform where each store can have its own branding, products, and settings.","archived":false,"fork":false,"pushed_at":"2025-10-16T01:15:42.000Z","size":9103,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-17T01:20:57.960Z","etag":null,"topics":["nuxt","typescript","vee-validate","vue","vuetify","zod"],"latest_commit_sha":null,"homepage":"https://cloudmerce.vertocode.com","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vertocode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-10-23T00:01:13.000Z","updated_at":"2025-10-16T01:15:46.000Z","dependencies_parsed_at":"2025-10-16T21:18:39.331Z","dependency_job_id":"2d92e1e0-7166-451e-bf72-9a08a920fea5","html_url":"https://github.com/vertocode/cloudmerce","commit_stats":null,"previous_names":["vertocode/cloudmerce"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/vertocode/cloudmerce","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertocode%2Fcloudmerce","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertocode%2Fcloudmerce/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertocode%2Fcloudmerce/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertocode%2Fcloudmerce/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vertocode","download_url":"https://codeload.github.com/vertocode/cloudmerce/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertocode%2Fcloudmerce/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28056914,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-26T02:00:06.189Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["nuxt","typescript","vee-validate","vue","vuetify","zod"],"created_at":"2025-01-19T06:32:52.460Z","updated_at":"2025-12-26T16:49:56.404Z","avatar_url":"https://github.com/vertocode.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\" style=\"background-color: #fff;\"\u003e\n  \u003cimg src=\"assets/logo.png\" alt=\"Cloudmerce Logo\" width=\"150\"/\u003e\n\u003c/div\u003e\n\nA white-label e-commerce platform built for creating and managing online stores. This is the frontend application that handles the customer-facing storefront and admin dashboard.\n\n## Demo\n\n\u003ca href=\"https://youtu.be/iOhQDixUD4I\"\u003e\n  \u003cimg src=\"https://i.imgur.com/b4CWUE0.png\" alt=\"Demo\" style=\"width:100%;\"\u003e\n\u003c/a\u003e\n\n## What is this?\n\nCloudmerce is a full-featured e-commerce system that lets you run multiple online stores from a single codebase. Think of it as your own customizable shopping platform where each store can have its own branding, products, and settings.\n\nThe platform handles everything you'd expect from a modern e-commerce site - product catalogs, shopping carts, order management, and payment processing. It's built to be fast, scalable, and easy to customize.\n\n## Tech Stack\n\nBuilt with modern web technologies:\n\n- **Nuxt 3** - The Vue.js framework that powers the whole thing\n- **Vue 3** - Composition API for reactive components\n- **Vuetify 3** - Material Design components for a clean UI\n- **VeeValidate + Zod** - Form validation with schema validation\n- **TypeScript** - For type safety and better developer experience\n- **SCSS** - CSS with superpowers for styling\n- **Tiptap** - Rich text editor for product descriptions and content\n- **EmailJS** - Contact form handling\n- **Stripe** - Credit card payment processing\n- **Mercado Pago** - Split payment support for marketplace functionality\n- **Asaas** - PIX payment integration for Brazilian market\n\n## Getting Started\n\nClone the repo and install dependencies:\n\n```shell\ngit clone git@github.com:vertocode/cloudmerce.git\ncd cloudmerce\nbun install\n```\n\nFire up the dev server:\n\n```shell\nbun dev\n```\n\nThat's it. Your local server should be running at `http://localhost:3000`\n\n## Project Structure\n\n```\ncloudmerce/\n├── components/          # Vue components\n│   ├── Admin/          # Admin-specific components\n│   ├── Md/             # Main design system components\n│   ├── Page/           # Page section components\n│   └── Vee/            # VeeValidate form components\n├── composables/         # Reusable composition functions\n├── layouts/             # App layouts (default, admin, no-container)\n├── middleware/          # Route middleware (auth guards)\n├── pages/               # File-based routing pages\n│   ├── admin/          # Admin dashboard pages\n│   └── orders/         # Order management pages\n├── plugins/             # Nuxt plugins\n├── public/              # Static files\n├── styles/              # Global styles and SCSS variables\n├── types/               # TypeScript type definitions\n├── assets/              # Images, fonts, etc\n└── nuxt.config.ts       # Nuxt configuration\n```\n\n## Environment Variables\n\nCreate a `.env` file in the root directory with the following variables:\n\n```env\n# API Configuration\nAPI_URL=your_api_url\n\n# Stripe\nSTRIPE_PUBLISHABLE_KEY=your_stripe_publishable_key\nSTRIPE_SECRET_KEY=your_stripe_secret_key\n\n# EmailJS\nEMAILJS_SERVICE_ID=your_emailjs_service_id\nEMAILJS_TEMPLATE_ID=your_emailjs_template_id\nEMAILJS_USER_ID=your_emailjs_user_id\n\n# Mercado Pago\nMERCADO_PAGO_CLIENT_ID=your_mercado_pago_client_id\n```\n\n## Main Features\n\n**For Customers:**\n- Browse products with filters and search\n- Product catalog with image galleries and zoom functionality\n- Add items to cart with variant selection (colors, sizes, custom options)\n- Multiple payment methods: Credit Card (Stripe), PIX (Asaas), Mercado Pago\n- Real-time order tracking and history\n- User authentication with email verification\n- Password reset functionality\n- Responsive design optimized for mobile and desktop\n\n**For Admins:**\n- Full product management (CRUD operations) with CSV import/export\n- Product variants with colors, sizes, and custom options\n- Rich text editor for product descriptions\n- Product validation system with status indicators\n- Order management with status updates and email notifications\n- Customer information display in order details\n- Financial dashboard with Mercado Pago split payment tracking\n- Store whitelabel customization:\n  - Custom colors, logos, and branding\n  - Custom homepage layouts with drag-and-drop sections\n  - Custom page builder with rich content blocks\n  - Navigation menu configuration\n  - Device-specific visibility controls (mobile/desktop)\n- User role management (admin/superadmin)\n- Cart management and cleanup tools\n- Real-time order status updates sent to customers\n- Mercado Pago OAuth integration for marketplace features\n\n## Key Technical Features\n\n**Payment Processing:**\n- Stripe integration for international credit card payments\n- Mercado Pago with split payment support for marketplace scenarios\n- Asaas integration for PIX payments (Brazil)\n- QR code generation for PIX payments\n- Automatic order status updates based on payment status\n\n**White-label System:**\n- Multi-tenant architecture supporting multiple stores\n- Per-store customization (colors, logos, branding)\n- Custom page builder with draggable sections:\n  - Banner sections with optional links\n  - Product carousels with manual product selection\n  - Rich text content blocks\n  - Product listing sections with filters\n- Device-specific content visibility (mobile/desktop)\n- Custom navigation menu configuration\n\n**Product Management:**\n- Flexible product variant system (colors, sizes, text fields, numbers)\n- Color variants with hex code support\n- Image galleries with multiple images per product\n- Stock management (limited, unlimited, out of stock)\n- Product validation system with real-time status indicators\n- CSV import/export for bulk operations\n- Product type categorization\n\n**User Experience:**\n- Server-side rendering (SSR) for better SEO and performance\n- Responsive design with mobile-first approach\n- Image zoom and gallery navigation\n- Quick shop modal for products with variants\n- Real-time cart updates\n- Email notifications for order status changes\n- Contact form with EmailJS integration\n\n## Scripts\n\n```bash\nbun dev           # Start development server\nbun build         # Build for production\nbun preview       # Preview production build\nbun lint          # Run ESLint\nbun lint:fix      # Fix ESLint errors automatically\n```\n\n## License\n\nCustom license - commercial use restricted to the author, Everton Vanoni Fernandes. Check the LICENSE file for full details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvertocode%2Fcloudmerce","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvertocode%2Fcloudmerce","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvertocode%2Fcloudmerce/lists"}