Cyclo — Cycling React JS Template

Cyclo React is a feature-rich Bicycle & Local Business Marketplace HTML5 web application built as a fully functional React 18 app using Vite and Bootstrap 5. It ships with 35+ page-level components, a filterable photo gallery, a full e-commerce module with cart and checkout, a blog module, all built with modern functional React and zero class components.

Built for React developers delivering bicycle & local business marketplace html5 sites and applications. The codebase uses hooks exclusively — useState, useEffect, useContext, useRef, and custom hooks for state management and side effects. Every UI section is an isolated, reusable component. Swap the static JSON data sources for any REST API or headless CMS and the UI layer is immediately production-ready.

Everything in the Package

• 35+ page-level React components with React Router v6 client-side routing
• React 18 with Vite — fast HMR dev server and optimised production build out of the box
• React Router v6 — client-side routing with lazy-loaded page components via React.lazy()
• Bootstrap 5 — responsive grid and utility classes, no jQuery dependency
• React Context and useReducer for global state management (cart, filters, UI state)
• React Hook Form — field validation, error messages, and submission state on all forms
• Swiper React — touch-friendly carousels via SwiperSlide components
• All data sourced from typed JSON files in src/data/ — swap to fetch() or axios for live API
• Retina-ready, fully responsive from 320px to 1920px+
• ESLint configured — Airbnb ruleset with React Hooks plugin
• React Helmet Async — per-route title and meta description for SEO
• PropTypes defined on every component for clear prop contracts

Component Architecture

• Page components map 1:1 to routes — each in its own file under src/pages/
• Shared components: Navbar, Footer, BackToTop, and feature-specific cards and widgets
• Custom hooks encapsulate side effects and shared logic — separate from JSX templates
• React.lazy() and Suspense applied to secondary page bundles — code-split on route change
• CartContext (or FilterContext) wraps the router at root level — state accessible on every route
• useReducer manages complex state (cart, multi-step forms) — predictable action/state flow
• Folder structure: src/pages/, src/components/, src/hooks/, src/context/, src/data/

All 35 Pages

• /home-v1 — v3 — Three distinct hero and listing showcase layouts
• /services-2 — Business services in two layout variants
• /pricing-2 — Listing subscription plans in two layout variants
• /gallery — Business and cycle image gallery
• /listing-grid — Listings in filterable card grid
• /listing-list — Listings in full-width list view
• /listing-map — Listings on interactive map view
• /listing-details-3 — Three individual listing page styles
• /compare-listings — Side-by-side listing comparison
• /submit-listing — Dealer and business listing submission form
• /agent-archive — Agent directory
• /agent-details — Individual agent profile page
• /dealer-archive — Dealer directory
• /dealer-details — Individual dealer profile page
• /profile — User account profile page

Key Features

• 35 Fully Designed HTML5 Pages across home, listings, agents, blog, and account
• 3 Unique Home Layouts — distinct hero styles and listing showcase arrangements
• Bootstrap 5 — responsive, mobile-first grid system
• 3 Listing View Modes — Grid, List, and Map view for business and cycle browsing
• 3 Listing Detail Page Styles — three individual listing page layout variants
• Listing Comparison — compare multiple listings side-by-side
• Submit Listing Form — let dealers and businesses add their listings
• Agent Directory — agent archive with individual agent profile pages
• Dealer Directory — dealer archive with individual dealer profile pages
• Services Module — two services overview layout variants
• Pricing Plans — two pricing page layout variants for listing subscriptions
• User Profile Management — profile page, saved listings, and profile listings

Performance and SEO

• React Helmet Async sets per-route title and meta description for SEO on every page component
• React.lazy() and Suspense code-split secondary route bundles — home route loads fast
• Vite production build applies Rollup tree-shaking, chunk splitting, and asset hashing automatically
• All images carry descriptive alt props meeting WCAG 1.1.1
• Google Fonts loaded with font-display: swap to prevent invisible-text flash
• Lighthouse-optimised component structure — no unnecessary re-renders via memo and useCallback where needed

Use Cases

• Bicycle & Local Business Marketplace HTML5 Businesses: Launch a fast, interactive React SPA without building from scratch
• Frontend Developers: Hooks-first architecture with useState, useContext, and custom hooks — extend confidently
• Freelancers and Agencies: Deliver a polished bicycle & local business marketplace html5 site to clients using React with minimal setup time
• Startups: Production-ready Vite build, React Router v6, and component tree ready to wire to any REST API

Credits and Dependencies

• React 18 — MIT License
• Vite — MIT License
• React Router v6 — MIT License
• Bootstrap 5 — MIT License
• React Hook Form — MIT License
• React Helmet Async — MIT License
• Swiper React — MIT License
• Slick — MIT License
• Isotope — MIT License
• Countdown — MIT License
• Magnific — MIT License
• Lightbox — MIT License
• Select2 — MIT License
• Font Awesome 6 — Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT
• Google Fonts — SIL Open Font License
• Demo images: Unsplash — Unsplash License (free for commercial use, no attribution required)
• Demo images: Freepik — Freepik License (free for commercial use with attribution)
• All demo images are for preview purposes only and are NOT included in the download.

v1.0  Initial React Release
- React 18 with Vite build tooling and fast HMR
- 35+ page-level components with React Router v6 client-side routing
- React Context and useReducer for global state management
- React Hook Form with field validation on all forms
- React.lazy() and Suspense route-level code splitting
- React Helmet Async per-route SEO meta tags
- ESLint with Airbnb ruleset and React Hooks plugin configured