|
| 1 | +# CSA Solution Accelerators Landing Page |
| 2 | + |
| 3 | +A modern, responsive React-based landing page showcasing Microsoft's AI Solution Accelerators. Built with React 18, TypeScript, Vite, and Tailwind CSS, this application provides an intuitive interface for exploring and discovering AI accelerators, solution areas, and implementation resources. |
| 4 | + |
| 5 | +## Features |
| 6 | + |
| 7 | +- **Modern UI/UX**: Clean, professional design using Fluent UI components and Tailwind CSS |
| 8 | +- **Deep Linking**: Advanced navigation system with URL synchronization and smooth scrolling |
| 9 | +- **Search & Filtering**: Real-time search with multi-category filtering capabilities |
| 10 | +- **Responsive Design**: Mobile-first approach with touch-friendly interactions |
| 11 | +- **Performance Optimized**: Fast loading with code splitting and lazy loading |
| 12 | +- **Accessibility**: WCAG 2.1 AA compliant with keyboard navigation support |
| 13 | + |
| 14 | +## Technology Stack |
| 15 | + |
| 16 | +- **Frontend**: React 18 + TypeScript |
| 17 | +- **Build Tool**: Vite |
| 18 | +- **Styling**: Tailwind CSS + Fluent UI React Components |
| 19 | +- **Icons**: Fluent UI React Icons |
| 20 | +- **Deployment**: GitHub Pages |
| 21 | +- **Data**: Static JSON with dynamic filtering |
| 22 | + |
| 23 | +## Getting Started |
| 24 | + |
| 25 | +### Prerequisites |
| 26 | + |
| 27 | +- Node.js 18+ |
| 28 | +- npm or yarn package manager |
| 29 | + |
| 30 | +### Installation |
| 31 | + |
| 32 | +1. Clone the repository: |
| 33 | +```bash |
| 34 | +git clone https://github.com/your-username/csa-sas-ext-landingpage.git |
| 35 | +cd csa-sas-ext-landingpage |
| 36 | +``` |
| 37 | + |
| 38 | +2. Install dependencies: |
| 39 | +```bash |
| 40 | +npm install |
| 41 | +``` |
| 42 | + |
| 43 | +### Development |
| 44 | + |
| 45 | +To run the project locally in development mode: |
| 46 | + |
| 47 | +```bash |
| 48 | +npm run dev |
| 49 | +``` |
| 50 | + |
| 51 | +This will start the development server, typically at `http://localhost:5173`. The page will automatically reload when you make changes to the code. |
| 52 | + |
| 53 | +### Building |
| 54 | + |
| 55 | +To build the project for production: |
| 56 | + |
| 57 | +```bash |
| 58 | +npm run build |
| 59 | +``` |
| 60 | + |
| 61 | +This creates an optimized production build in the `dist/` directory. |
| 62 | + |
| 63 | +### Preview Build |
| 64 | + |
| 65 | +To preview the production build locally: |
| 66 | + |
| 67 | +```bash |
| 68 | +npm run preview |
| 69 | +``` |
| 70 | + |
| 71 | +## Live Demo |
| 72 | + |
| 73 | +Access the live version of the application at: |
| 74 | +**[https://cuddly-adventure-3j22l89.pages.github.io/](https://cuddly-adventure-3j22l89.pages.github.io/)** |
| 75 | + |
| 76 | +## Project Structure |
| 77 | + |
| 78 | +``` |
| 79 | +src/ |
| 80 | +├── components/ # React components |
| 81 | +│ ├── Header/ # Navigation and header components |
| 82 | +│ ├── HeroSection/ # Main hero section |
| 83 | +│ ├── FeaturedSection/ # Featured accelerators showcase |
| 84 | +│ ├── DifferentiatorSection/ # Solution differentiators |
| 85 | +│ ├── HowItWorksSection/ # Process explanation |
| 86 | +│ ├── SuccessStoriesSection/ # Customer success stories |
| 87 | +│ ├── Footer/ # Site footer |
| 88 | +│ └── shared/ # Reusable component utilities |
| 89 | +├── data/ # Static data and generated content |
| 90 | +│ ├── cards/ # Individual accelerator JSON files |
| 91 | +│ └── generated/ # Build-time generated data |
| 92 | +├── hooks/ # Custom React hooks |
| 93 | +├── utils/ # Utility functions and helpers |
| 94 | +├── types/ # TypeScript type definitions |
| 95 | +└── assets/ # Images, icons, and static assets |
| 96 | +``` |
| 97 | + |
| 98 | +## Key Components |
| 99 | + |
| 100 | +- **GsaCard**: Accelerator card component with hover effects and responsive design |
| 101 | +- **Navigation**: Sticky navigation with smooth scrolling and deep linking |
| 102 | +- **Search & Filters**: Advanced filtering by categories, solution areas, and technologies |
| 103 | +- **Responsive Grid**: Adaptive layout system for different screen sizes |
| 104 | + |
| 105 | +## Development Workflow |
| 106 | + |
| 107 | +1. **Feature Development**: Create feature branches from main |
| 108 | +2. **Testing**: Ensure all functionality works across browsers and devices |
| 109 | +3. **Code Quality**: Follow TypeScript best practices and component architecture |
| 110 | +4. **Performance**: Monitor bundle size and loading performance |
| 111 | +5. **Accessibility**: Maintain WCAG compliance standards |
| 112 | + |
| 113 | +## Contributing |
| 114 | + |
| 115 | + |
| 116 | + |
| 117 | +For major changes, please open an issue first to discuss the proposed changes. |
| 118 | + |
| 119 | +## License |
| 120 | + |
| 121 | +This project is licensed under the MIT License - see the LICENSE file for details. |
| 122 | + |
| 123 | +## Support |
| 124 | + |
| 125 | +For questions or support, please: |
| 126 | +- Open an issue on GitHub |
| 127 | +- Contact the development team |
| 128 | +- Check the documentation in the `/docs` folder |
| 129 | + |
| 130 | +--- |
| 131 | + |
| 132 | +**Built with ❤️ by the Microsoft AI Solution Accelerators team** |
0 commit comments