{"id":50993015,"url":"https://github.com/nrbnayon/amora_ai","last_synced_at":"2026-06-20T05:30:35.739Z","repository":{"id":318210233,"uuid":"1070172981","full_name":"nrbnayon/amora_ai","owner":"nrbnayon","description":"Amora AI is a comprehensive wedding planning platform that leverages artificial intelligence to help couples plan their dream wedding. From venue selection to guest management, budget tracking, and timeline coordination - all in one intelligent platform.","archived":false,"fork":false,"pushed_at":"2026-02-03T14:12:37.000Z","size":29726,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-04T01:33:48.612Z","etag":null,"topics":["admin-dashboard","best-practices","nextjs16","react-hook-form","responsive-web-design","shadcn-ui","tailwindcss-v4","typescript"],"latest_commit_sha":null,"homepage":"https://amora-ai.vercel.app","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/nrbnayon.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-10-05T12:20:23.000Z","updated_at":"2026-02-03T14:14:01.000Z","dependencies_parsed_at":"2025-10-05T21:26:11.854Z","dependency_job_id":null,"html_url":"https://github.com/nrbnayon/amora_ai","commit_stats":null,"previous_names":["nrbnayon/amora_ai"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nrbnayon/amora_ai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nrbnayon%2Famora_ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nrbnayon%2Famora_ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nrbnayon%2Famora_ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nrbnayon%2Famora_ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nrbnayon","download_url":"https://codeload.github.com/nrbnayon/amora_ai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nrbnayon%2Famora_ai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34558892,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-20T02:00:06.407Z","response_time":98,"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":["admin-dashboard","best-practices","nextjs16","react-hook-form","responsive-web-design","shadcn-ui","tailwindcss-v4","typescript"],"created_at":"2026-06-20T05:30:33.278Z","updated_at":"2026-06-20T05:30:35.734Z","avatar_url":"https://github.com/nrbnayon.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Amora AI - AI-Powered Wedding Planning Platform\n\nAmora AI is a comprehensive wedding planning platform that leverages artificial intelligence to help couples plan their dream wedding. From venue selection to guest management, budget tracking, and timeline coordination - all in one intelligent platform.\n\n## 🌟 Features\n\n### Core Functionality\n- **AI-Powered Wedding Planning**: Intelligent assistance for every aspect of wedding planning\n- **Venue Selection**: Smart venue recommendations based on preferences and budget\n- **Guest Management**: Comprehensive guest list management with RSVP tracking\n- **Budget Tracking**: Detailed budget planning and expense monitoring\n- **Timeline Coordination**: Automated timeline creation and task management\n- **Vendor Management**: Connect with and manage wedding vendors\n\n### User Experience\n- **Responsive Design**: Fully responsive interface that works on all devices\n- **Dark Mode Support**: Built-in dark mode toggle for better user experience\n- **Intuitive Onboarding**: Step-by-step onboarding process for new users\n- **Dashboard Analytics**: Visual insights into wedding planning progress\n\n### Technical Features\n- **Modern Tech Stack**: Built with Next.js 15, React 19, and TypeScript\n- **Performance Optimized**: Uses Turbopack for fast development and builds\n- **SEO Optimized**: Comprehensive SEO configuration with structured data\n- **Analytics Integration**: Vercel Analytics and Speed Insights enabled\n- **Form Validation**: Zod-based form validation with React Hook Form\n\n## 🚀 Tech Stack\n\n### Frontend\n- **Next.js 15.5.4** - React framework for production\n- **React 19.1.0** - Latest React version\n- **TypeScript** - Type-safe JavaScript\n- **Tailwind CSS 4** - Utility-first CSS framework\n- **Radix UI** - Unstyled, accessible component primitives\n- **Framer Motion** - Animation library for smooth interactions\n\n### State Management \u0026 Forms\n- **React Hook Form** - Performant forms with built-in validation\n- **Zod** - TypeScript-first schema validation\n- **React Redux** - State management\n\n### UI/UX\n- **Lucide React** - Beautiful \u0026 consistent icon pack\n- **Geist Font** - Modern, clean typography from Vercel\n- **Embla Carousel** - Touch-friendly carousel component\n- **Recharts** - Composable charting library\n\n### Development \u0026 Deployment\n- **Vercel** - Platform for deployment and analytics\n- **Turbopack** - Fast bundler for development\n- **PostCSS** - CSS processing and optimization\n\n## 📁 Project Structure\n\n```\namora_ai/\n├── app/                          # Next.js App Router\n│   ├── (auth)/                   # Authentication pages\n│   ├── (dashboard)/              # Dashboard pages\n│   ├── (onboarding)/             # User onboarding\n│   ├── admin/                    # Admin panel\n│   └── layout.tsx               # Root layout\n├── components/                     # React components\n│   ├── auth/                     # Authentication components\n│   ├── dashboard/                # Dashboard components\n│   ├── landing/                  # Landing page sections\n│   ├── layout/                   # Layout components\n│   └── ui/                       # Reusable UI components\n├── lib/                          # Utilities and configurations\n│   ├── constants/                # App constants\n│   ├── types/                    # TypeScript types\n│   └── utils/                    # Helper functions\n├── public/                       # Static assets\n│   ├── events/                   # Event-related images\n│   ├── vendors/                  # Vendor category images\n│   └── [other assets]\n└── [config files]\n```\n\n## 🛠️ Getting Started\n\n### Prerequisites\n- Node.js 18+ \n- npm or yarn package manager\n\n### Installation\n\n1. Clone the repository:\n```bash\ngit clone [repository-url]\ncd amora_ai\n```\n\n2. Install dependencies:\n```bash\nnpm install\n# or\nyarn install\n```\n\n3. Set up environment variables:\nCreate a `.env.local` file in the root directory and add:\n```env\nNEXT_PUBLIC_APP_URL=http://localhost:3000\nNEXT_PUBLIC_API_URL=/api\nGOOGLE_SITE_VERIFICATION=your_google_verification_code\n```\n\n4. Run the development server:\n```bash\nnpm run dev\n# or\nyarn dev\n```\n\n5. Open [http://localhost:3000](http://localhost:3000) in your browser.\n\n## 📊 Available Scripts\n\n- `npm run dev` - Start development server with Turbopack\n- `npm run build` - Build for production with Turbopack\n- `npm run start` - Start production server\n\n## 🎯 Key Components\n\n### Authentication System\n- Multi-step authentication flow\n- Social authentication support (Google, Facebook, Apple)\n- Password reset functionality\n- Email verification system\n\n### Dashboard Features\n- **Budget Management**: Track wedding expenses by category\n- **Guest Management**: RSVP tracking and guest list organization\n- **Vendor Directory**: Browse and connect with wedding vendors\n- **Timeline Planner**: Visual timeline with task management\n- **AI Assistant**: Intelligent recommendations and planning assistance\n\n### Admin Panel\n- User management\n- Analytics dashboard\n- Content management\n- System monitoring\n\n## 🔧 Configuration\n\n### App Configuration\nThe application configuration is managed through `lib/constants/index.ts`:\n- App metadata (name, description, version)\n- API configuration\n- Authentication settings\n- Feature flags\n- Route definitions\n\n### Theme Configuration\n- Dark mode support with next-themes\n- Custom color scheme in `lib/design-tokens.ts`\n- Responsive breakpoints configuration\n\n## 📱 Responsive Design\n\nThe application is fully responsive with breakpoints:\n- Mobile: \u003c 640px\n- Tablet: 640px - 1024px\n- Desktop: \u003e 1024px\n\n## 🔒 Security Features\n\n- Form validation with Zod schemas\n- Secure authentication flow\n- Input sanitization\n- XSS protection\n- CSRF protection (when deployed)\n\n## 📈 Performance Optimizations\n\n- **Turbopack**: Fast development builds\n- **Image Optimization**: Next.js Image component for optimized loading\n- **Code Splitting**: Automatic code splitting for better performance\n- **Lazy Loading**: Components loaded on demand\n- **Caching**: Strategic caching strategies\n\n## 🌐 SEO \u0026 Analytics\n\n- Comprehensive meta tags and structured data\n- Open Graph and Twitter Card support\n- Google Search Console verification\n- Vercel Analytics integration\n- Performance monitoring with Speed Insights\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## 🆘 Support\n\nFor support, email support@amoraai.com or join our Slack channel.\n\n## 🌟 Acknowledgments\n\n- Built with modern web technologies\n- Inspired by the need for intelligent wedding planning solutions\n- Thanks to all contributors and the open-source community\n\n---\n\n**Happy Wedding Planning!** 💍✨\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnrbnayon%2Famora_ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnrbnayon%2Famora_ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnrbnayon%2Famora_ai/lists"}