{"id":40665248,"url":"https://github.com/javigong/vyoniq","last_synced_at":"2026-01-21T09:08:13.019Z","repository":{"id":316796905,"uuid":"999954881","full_name":"javigong/vyoniq","owner":"javigong","description":"Vyoniq is a modern Software Development company powered by AI agents, delivering innovative solutions with the efficiency of a large team. We specialize in Web and Mobile App Development, secure Hosting Services, and cutting-edge AI Integrations.  This repository contains the source code for the official Vyoniq SaaS platform.","archived":false,"fork":false,"pushed_at":"2025-12-17T06:30:46.000Z","size":11933,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-20T19:50:41.438Z","etag":null,"topics":["admin-dashboard","ai-agents","authentication","content-management-system","coolify","email-integration","mcp-server","newsletter-management","nextjs","payments","postgres","prisma","resend-email-api","shadcn-ui","stripe","tailwindcss","typescript","user-management"],"latest_commit_sha":null,"homepage":"https://vyoniq.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/javigong.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2025-06-11T03:51:56.000Z","updated_at":"2025-12-17T06:30:46.000Z","dependencies_parsed_at":"2025-09-26T20:25:57.529Z","dependency_job_id":"1db551dd-1863-4301-89cf-c41b9ff8a12e","html_url":"https://github.com/javigong/vyoniq","commit_stats":null,"previous_names":["javigong/vyoniq"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/javigong/vyoniq","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/javigong%2Fvyoniq","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/javigong%2Fvyoniq/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/javigong%2Fvyoniq/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/javigong%2Fvyoniq/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/javigong","download_url":"https://codeload.github.com/javigong/vyoniq/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/javigong%2Fvyoniq/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28630940,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T04:47:28.174Z","status":"ssl_error","status_checked_at":"2026-01-21T04:47:22.943Z","response_time":86,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["admin-dashboard","ai-agents","authentication","content-management-system","coolify","email-integration","mcp-server","newsletter-management","nextjs","payments","postgres","prisma","resend-email-api","shadcn-ui","stripe","tailwindcss","typescript","user-management"],"created_at":"2026-01-21T09:08:12.266Z","updated_at":"2026-01-21T09:08:13.008Z","avatar_url":"https://github.com/javigong.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vyoniq\n\n[![Deployed with Coolify](https://img.shields.io/badge/Deployed%20with-Coolify-blue?style=for-the-badge\u0026logo=docker)](https://coolify.io/)\n\n\u003e Innovate Faster with AI-Powered Software Solutions\n\nVyoniq is a modern Software Development company powered by AI agents, delivering innovative solutions with the efficiency of a large team. We specialize in Web and Mobile App Development, secure Hosting Services, and cutting-edge AI Integrations.\n\nThis repository contains the source code for the official Vyoniq SaaS platform, featuring a comprehensive landing page, client management system, and AI-powered tools.\n\n## 📸 Screenshots\n\n### Landing Page \u0026 Services\n\n![Homepage Hero Section](screenshots/homepage-hero.png)\n_Modern, futuristic landing page with AI-powered design and clear service offerings_\n\n![Services Overview](screenshots/services-overview.png)\n_Comprehensive showcase of Web \u0026 Mobile Development, Hosting, and AI Integration services_\n\n![Custom Apps Section](screenshots/vyoniq-apps.png)\n_Dedicated section for custom application development services_\n\n### Client Dashboard \u0026 Management\n\n![User Dashboard](screenshots/user-dashboard.png)\n_Client dashboard showing inquiries, project status, and subscription management_\n\n![Admin Dashboard](screenshots/admin-dashboard.png)\n_Comprehensive admin dashboard with analytics and management tools_\n\n### Blog \u0026 Content Management\n\n![Blog System](screenshots/blog-system.png)\n_Modern blog with category filtering and responsive design_\n\n![Blog Admin](screenshots/blog-admin.png)\n_Admin blog management interface with full CRUD operations_\n\n### Payment \u0026 Subscription System\n\n![Payment Success](screenshots/payment-success.png)\n_Stripe-integrated payment processing with multi-currency support (USD/CAD)_\n\n![Subscription Management](screenshots/subscription-management.png)\n_Comprehensive subscription management with billing and trial periods_\n\n### MCP Server Integration\n\n![MCP Server Tools](screenshots/mcp-server.png)\n_Model Context Protocol server with AI agent integration for blog and inquiry management_\n\n## ✨ Features\n\n### 🏠 Landing Page \u0026 Marketing\n\n- **Modern Hero Section:** Futuristic design with glassmorphism effects and clear value proposition\n- **Service Showcase:** Comprehensive display of Web \u0026 Mobile Development, Hosting, and AI Integration services\n- **Custom Apps Page:** Dedicated section highlighting tailored application development capabilities\n- **About Page:** Professional company and founder information\n- **Contact System:** Advanced inquiry management with status tracking and email notifications\n- **Newsletter System:** Full newsletter management with welcome emails and content distribution\n- **SEO Optimized:** Complete SEO implementation with structured data and meta optimization\n\n### 👤 User Management \u0026 Authentication\n\n- **Clerk Integration:** Secure authentication with sign-up/sign-in flows\n- **User Dashboard:** Personalized dashboard showing project status, inquiries, and subscriptions\n- **Profile Management:** User profile editing and account management\n- **Role-Based Access:** Admin and user role separation with appropriate permissions\n- **Account Deletion:** GDPR-compliant account deletion with data cleanup\n\n### 📊 Admin Dashboard \u0026 Analytics\n\n- **Comprehensive Analytics:** Real-time statistics for inquiries, budgets, subscriptions, and blog posts\n- **Inquiry Management:** Full CRUD operations for client inquiries with status tracking\n- **Budget Management:** Create, send, and track project budgets with approval workflows\n- **Subscription Management:** Complete subscription lifecycle management with Stripe integration\n- **User Management:** Admin tools for user account management and role assignment\n- **Newsletter Management:** Create, send, and track newsletter campaigns\n\n### 💳 Payment \u0026 Subscription System\n\n- **Stripe Integration:** Secure payment processing with webhook support\n- **Multi-Currency Support:** USD and CAD currency options for global clients\n- **Subscription Management:** Recurring billing with trial periods and plan management\n- **One-Time Payments:** Budget-based payment system for project-based work\n- **Payment Success Pages:** Comprehensive post-payment experience with next steps\n- **Automatic Invoicing:** Stripe-powered invoice generation and management\n\n### 📝 Blog \u0026 Content Management\n\n- **Full Blog System:** Complete blog with categories, tags, and author management\n- **Admin Blog Interface:** Rich admin interface for creating and managing blog content\n- **Category Management:** Dynamic category system with post association\n- **SEO Features:** Blog-specific SEO optimization with meta tags and structured data\n- **Related Posts:** AI-powered related post suggestions\n- **Social Sharing:** Built-in social media sharing buttons\n- **Responsive Design:** Mobile-optimized blog reading experience\n\n### 🤖 MCP Server \u0026 AI Integration\n\n- **Model Context Protocol Server:** Full MCP server implementation for AI agent integration\n- **Blog Management Tools:** AI-powered blog creation, editing, and category suggestions\n- **Inquiry Management:** Automated inquiry processing and response tools\n- **Resource Management:** Dynamic resource resolution for blog posts, categories, and analytics\n- **API Authentication:** Dual authentication system (Clerk sessions + API keys)\n- **Tool Categories:** Organized tool sets for blog management, inquiry handling, and user management\n\n### 🔧 Technical Features\n\n- **Modern Architecture:** Next.js App Router with TypeScript for type safety\n- **Database Integration:** PostgreSQL with Prisma ORM for robust data management\n- **Email System:** Resend integration for transactional and marketing emails\n- **File Management:** Optimized image handling with Next.js Image component\n- **Performance Optimized:** \u003c2s load times with lazy loading and code splitting\n- **Accessibility:** WCAG 2.1 compliant with proper ARIA labels and keyboard navigation\n- **Dark Mode:** Full dark mode support with theme persistence\n\n## 🚀 Tech Stack\n\n### Frontend \u0026 UI\n\n- **Framework:** [Next.js](https://nextjs.org/) (App Router) with TypeScript\n- **UI Components:** [shadcn/ui](https://ui.shadcn.com/) for accessible, customizable components\n- **Styling:** [Tailwind CSS](https://tailwindcss.com/) with custom design system\n- **Icons:** [Lucide React](https://lucide.dev/) for consistent iconography\n- **Animations:** CSS animations with Tailwind for smooth interactions\n\n### Backend \u0026 Database\n\n- **Database:** [PostgreSQL](https://www.postgresql.org/) with [Prisma ORM](https://prisma.io/)\n- **Authentication:** [Clerk](https://clerk.com/) with role-based access control\n- **API:** Next.js API routes with TypeScript and Zod validation\n- **File Storage:** Next.js optimized image handling\n\n### Payments \u0026 Subscriptions\n\n- **Payment Processing:** [Stripe](https://stripe.com/) with webhook integration\n- **Multi-Currency:** USD and CAD support\n- **Subscription Management:** Recurring billing with trial periods\n- **Invoice Generation:** Automated Stripe invoicing\n\n### Email \u0026 Communications\n\n- **Email Service:** [Resend](https://resend.com/) for transactional emails\n- **Newsletter System:** Custom newsletter management with email templates\n- **Notifications:** Real-time status updates and email confirmations\n\n### AI \u0026 Integration\n\n- **MCP Server:** Custom Model Context Protocol server implementation\n- **AI Tools:** Blog content management and category suggestions\n- **API Keys:** Secure API key management for external integrations\n- **Webhooks:** Stripe webhook handling for payment events\n\n### Development \u0026 Deployment\n\n- **Package Manager:** [pnpm](https://pnpm.io/) for efficient dependency management\n- **Type Safety:** Full TypeScript implementation with strict mode\n- **Code Quality:** ESLint and Prettier for consistent code formatting\n- **Deployment:** [Coolify](https://coolify.io/) on custom VPS with automated CI/CD\n- **Monitoring:** Built-in error handling and logging\n\n## 🛠️ Getting Started\n\nFollow these instructions to set up the project locally for development and testing.\n\n### Prerequisites\n\n- [Node.js](https://nodejs.org/en/) (v18.x or later)\n- [pnpm](https://pnpm.io/installation) (or `npm`/`yarn`)\n\n### Installation\n\n1.  **Clone the repository:**\n\n    \\`\\`\\`sh\n    git clone https://github.com/JaviGong/vyoniq.git\n    cd vyoniq\n    \\`\\`\\`\n\n2.  **Install dependencies:**\n\n    \\`\\`\\`sh\n    pnpm install\n    \\`\\`\\`\n\n3.  **Set up environment variables:**\n\n    Create a `.env.local` file in the root of the project. You can copy the `.env.example` file to get started:\n\n    \\`\\`\\`sh\n    cp .env.example .env.local\n    \\`\\`\\`\n\n    You will need to add your credentials for [Clerk](https://clerk.com/) and connect to your [PostgreSQL](https://www.postgresql.org/) instance.\n\n4.  **Run the development server:**\n\n    \\`\\`\\`sh\n    pnpm dev\n    \\`\\`\\`\n\n    Open [http://localhost:3000](http://localhost:3000) in your browser to see the result.\n\n## 🤖 MCP Server Integration\n\nVyoniq features a comprehensive Model Context Protocol (MCP) server that enables AI agents to interact with the platform's data and functionality. The MCP server provides a standardized interface for AI tools to manage content, analyze data, and automate workflows.\n\n### Key Capabilities\n\n- **Blog Management Tools:** AI-powered blog post creation, editing, publishing, and category management\n- **Inquiry Processing:** Automated customer inquiry handling with status tracking and response generation\n- **Content Analytics:** Real-time analytics and insights for blog performance and user engagement\n- **Resource Management:** Dynamic access to blog posts, categories, authors, and system information\n- **Dual Authentication:** Supports both Clerk session authentication and API key authentication\n\n### Available Tools\n\n#### Blog Management\n\n- `create_blog_post` - Create new blog posts with metadata and categories\n- `update_blog_post` - Edit existing blog content and settings\n- `publish_blog_post` - Control blog post publication status\n- `delete_blog_post` - Remove blog posts permanently\n- `suggest_categories_for_post` - AI-powered category suggestions based on content\n- `bulk_update_posts` - Mass operations on multiple blog posts\n- `list_blog_posts` - Retrieve blog posts with filtering options\n- `get_blog_post` - Get detailed information about specific posts\n\n#### Category Management\n\n- `create_category` - Add new blog categories\n- `update_category` - Modify category names and slugs\n- `delete_category` - Remove categories with post migration options\n- `list_categories` - Get all available categories\n\n#### Inquiry Management\n\n- `list_inquiries` - View customer inquiries with status filtering\n- `get_inquiry` - Get detailed inquiry information with conversation history\n- `update_inquiry_status` - Change inquiry status (PENDING, IN_PROGRESS, RESOLVED, CLOSED)\n- `respond_to_inquiry` - Send responses that automatically email customers\n- `create_inquiry` - Create new inquiries for testing\n- `get_inquiry_stats` - Get statistics about inquiry statuses\n\n#### System Management\n\n- `delete_user_account` - Admin-only tool for GDPR-compliant account deletion\n- `revalidate_blog` - Trigger cache revalidation for updated content\n\n### Resource Access\n\nThe MCP server provides structured access to:\n\n- `vyoniq://blog/posts` - All blog posts with metadata\n- `vyoniq://blog/posts/{postId}` - Individual blog post content\n- `vyoniq://blog/categories` - Category information\n- `vyoniq://blog/authors` - Author profiles and statistics\n- `vyoniq://server/info` - Server capabilities and information\n- `vyoniq://analytics/dashboard` - Admin analytics overview\n\n### Usage with AI Clients\n\nThe MCP server is designed to work with AI clients like Cursor IDE, Claude Desktop, and other MCP-compatible tools. It provides a secure, authenticated interface for AI agents to:\n\n1. **Content Creation:** Generate and publish blog posts with proper SEO optimization\n2. **Customer Service:** Process and respond to customer inquiries automatically\n3. **Content Management:** Organize and categorize content intelligently\n4. **Analytics:** Generate insights from blog and user data\n5. **Workflow Automation:** Streamline content publishing and customer communication\n\n### API Endpoint\n\nThe MCP server is accessible at `/api/mcp` and follows the JSON-RPC 2.0 protocol specification. Authentication is required for all operations, supporting both Clerk sessions and API keys for different use cases.\n\n## 🚢 Deployment \u0026 Production\n\n### Deployment Platform\n\nThis project is deployed on a custom VPS using [Coolify](https://coolify.io/) for automated deployment and container management. The deployment pipeline provides:\n\n- **Automated CI/CD:** Monitors the `main` branch and triggers deployments on push\n- **Container Management:** Docker-based deployment with optimized production builds\n- **Environment Management:** Secure environment variable handling and secrets management\n- **SSL/TLS:** Automated SSL certificate provisioning and renewal\n- **Monitoring:** Built-in application monitoring and health checks\n\n### Production Architecture\n\n- **Application Server:** Next.js production build with optimized static generation\n- **Database:** PostgreSQL with automated backups and connection pooling\n- **Email Service:** Resend for reliable email delivery with high deliverability\n- **Payment Processing:** Stripe with webhook endpoint security\n- **File Storage:** Optimized image serving with CDN capabilities\n- **Security:** Rate limiting, CORS configuration, and secure headers\n\n### Environment Variables\n\nRequired environment variables for deployment:\n\n```bash\n# Database\nDATABASE_URL=postgresql://...\n\n# Authentication (Clerk)\nNEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_...\nCLERK_SECRET_KEY=sk_...\nCLERK_WEBHOOK_SECRET=whsec_...\n\n# Payments (Stripe)\nSTRIPE_SECRET_KEY=sk_...\nNEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_...\nSTRIPE_WEBHOOK_SECRET=whsec_...\n\n# Email (Resend)\nRESEND_API_KEY=re_...\n\n# Application\nNEXT_PUBLIC_APP_URL=https://vyoniq.com\nNEXTAUTH_SECRET=...\nMCP_API_SECRET=...\n```\n\n### Deployment Process\n\n1. **Code Push:** Changes pushed to `main` branch\n2. **Build Trigger:** Coolify detects changes and starts build process\n3. **Container Build:** Docker image built with production optimizations\n4. **Database Migration:** Prisma migrations applied automatically\n5. **Health Checks:** Application health verified before traffic routing\n6. **Live Deployment:** New version goes live with zero downtime\n7. **Monitoring:** Continuous monitoring for performance and errors\n\n### Performance Optimizations\n\n- **Static Generation:** Blog posts and service pages pre-generated at build time\n- **Image Optimization:** Next.js Image component with WebP conversion\n- **Code Splitting:** Automatic code splitting for optimal loading\n- **Caching:** Aggressive caching strategies for static content\n- **Database Optimization:** Query optimization and connection pooling\n- **CDN Integration:** Static assets served through optimized delivery network\n\n## 🔌 API Documentation\n\nVyoniq provides several API endpoints for different functionalities:\n\n### Public APIs\n\n- **Blog Posts:** `/api/blog/posts` - Retrieve published blog posts with filtering\n- **Service Pricing:** `/api/service-pricing` - Get current service pricing information\n- **Contact Form:** `/api/inquiries` - Submit customer inquiries\n\n### Authenticated APIs (User)\n\n- **User Dashboard:** `/api/user` - Get user profile and dashboard data\n- **Inquiries:** `/api/inquiries` - Manage user's inquiries and communications\n- **Subscriptions:** `/api/subscriptions` - View and manage user subscriptions\n- **Budgets:** `/api/budgets` - Access project budgets and payment information\n\n### Admin APIs (Admin Only)\n\n- **Blog Management:** `/api/admin/blog` - Full CRUD operations for blog content\n- **User Management:** `/api/admin/users` - User account management\n- **Analytics:** `/api/admin/analytics` - Platform analytics and statistics\n- **Newsletter:** `/api/admin/newsletter` - Newsletter management and distribution\n\n### Payment APIs\n\n- **Stripe Checkout:** `/api/payments/create-checkout-session` - Create payment sessions\n- **Subscription Billing:** `/api/subscriptions/create-checkout-session` - Handle recurring billing\n- **Webhooks:** `/api/webhooks/stripe` - Process Stripe webhook events\n\n### MCP Server\n\n- **MCP Endpoint:** `/api/mcp` - Model Context Protocol server for AI integration\n- **Authentication:** Supports both Clerk sessions and API keys\n- **Tools:** 20+ tools for blog management, inquiry processing, and analytics\n- **Resources:** Dynamic resource access for content and system data\n\n### Email Integration\n\n- **Transactional Emails:** Automated via Resend for confirmations and notifications\n- **Newsletter System:** Custom email templates and delivery tracking\n- **Webhook Processing:** Real-time email event handling\n\nAll APIs use TypeScript with Zod validation for type safety and include proper error handling, rate limiting, and security measures. Authentication is handled via Clerk with role-based access control for admin functions.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjavigong%2Fvyoniq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjavigong%2Fvyoniq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjavigong%2Fvyoniq/lists"}