Skip to content

Releases: osama2kabdullah/cf-react-boilerplate

v1.0.0 Release Notes

11 Apr 07:50
@osama2kabdullah osama2kabdullah
v1.0.0
cc34f55

Choose a tag to compare

View all tags
v1.0.0 Release Notes Latest
Latest

Overview

CF React Boilerplate v1.0.0 is the first stable release of a production-grade React frontend template engineered for performance, scalability, and static deployment on Cloudflare Pages.

Key Features

  • Vite 6 with Rolldown/OXC pipeline for ultra-fast builds (~800ms)
  • React 18 with Concurrent rendering and lazy-loaded pages
  • TypeScript 5 in strict mode for type safety
  • React Router v6 with code splitting per page
  • Zustand 4 for minimal, focused global state
  • Raw CSS + IBM Carbon Design Tokens — zero CSS-in-JS overhead
  • Progressive Web App (PWA) with Workbox auto-precaching
  • Custom data fetching with useFetch hook — automatic caching, deduplication, stale-while-revalidate
  • Smart loading UX — LoadingBar + Skeleton components prevent blank screens
  • Cloudflare Pages optimized — SPA routing, caching headers, edge-compatible fetch

What's Included

  • Pre-configured routing with 6 demo pages (Home, Dashboard, Posts, Settings, 404)
  • Reusable UI component library (Button, Card, Tag, Spinner, Skeleton, Notification)
  • Layout components (Header, Footer, PageShell)
  • Custom hooks (useFetch, useTheme, useDebounce, useMediaQuery, useDocumentTitle)
  • API service layer with typed HTTP client
  • CSS architecture following IBM Carbon principles
  • ESLint configuration with TypeScript support
  • Vite PWA plugin with service worker generation

Performance

  • Initial HTML: 1.83 KB
  • CSS bundle: 22.4 KB (4.9 KB gzipped)
  • Vendor chunk: 250 KB (81 KB gzipped)
  • Largest page chunk: 4.7 KB (1.5 KB gzipped)
  • Total first-load: ~90 KB (gzipped)

Quick Start

npm install
npm run dev          # http://localhost:3000
npm run build        # Production build
npm run preview      # Preview build locally
npm run typecheck    # Type checking only

Documentation

See README.md for:

  • Complete architecture decisions
  • Deployment to Cloudflare Pages
  • Extending the boilerplate
  • Edge API integration patterns

Production Ready

This boilerplate is tested and optimized for:

  • Modern browser compatibility (ES2020+)
  • Static deployment on Cloudflare Pages
  • Cloudflare Workers API integration
  • Offline-first PWA experience
Assets 2
Loading