Ivyi Web Application

Welcome to the comprehensive documentation for the Ivyi web application. This React Router-based frontend provides an intuitive and delightful user experience for celebration and gifting activities.

🎯 About the Web App

The Ivyi web application is the user-facing component of our revolutionary gifting platform. Built with modern React Router and TypeScript, it provides seamless experiences for creating occasions, managing gifts, and connecting with friends and family.

🏗️ Technology Stack

• Framework: React Router with TypeScript
• Styling: TailwindCSS for utility-first styling
• Build Tool: Vite for fast development and building
• State Management: React Router's built-in data loading
• Type Safety: End-to-end TypeScript integration
• Icons: Lucide React for consistent iconography
• UI Components: Custom component library (@ivyi/ui)

🚀 Getting Started

Prerequisites

• Node.js 22+
• npm or yarn package manager
• Modern web browser

Development Setup

1. Navigate to web directory

   cd apps/web

2. Install dependencies

   npm install

3. Start development server

   npm run dev

4. Access application

   http://localhost:5173

🛠️ Development Tools

Available Scripts

• npm run dev - Start development server with hot reload
• npm run build - Build for production
• npm run preview - Preview production build locally
• npm run test - Run test suite
• npm run lint - Code quality checks