jengo/react-starter-kit

CodeIgniter4 React starter kit

dev-master 2025-07-27 07:37 UTC

This package is not auto-updated.

Last update: 2025-07-28 02:50:08 UTC


README

Packagist Version Packagist Downloads License

A modern CodeIgniter 4 + React starter template powered by Inertia.js, built to kickstart your next full-stack project with zero boilerplate hassle.

This starter kit uses React with Webpack and Tailwind CSS pre-configured. Backend powered by CodeIgniter 4, bridged by Inertia.js.

๐Ÿš€ Getting Started

1. Create a New Project

composer create-project jengo/react-start-kit my-app

2. Install Dependencies

cd my-app

# Install JS dependencies
npm install

3. Run Dev Server

npm run dev

By default, the development server runs at http://localhost:8080.

Internally this runs php spark serve.

๐Ÿงฉ Included Features

  • โœ… React 19
  • โœ… Webpack for fast builds
  • โœ… Tailwind CSS
  • โœ… Inertia.js (React adapter)
  • โœ… Clean project structure
  • โœ… TypeScript-ready (opt-in)
  • โœ… Example routing + layout system

๐Ÿ“ Project Structure

โ”œโ”€โ”€ app/                   # CI4 controllers & config
โ”œโ”€โ”€ public/
โ”‚   โ””โ”€โ”€ index.php
โ”œโ”€โ”€ resources/
โ”‚   โ””โ”€โ”€ js/
โ”‚       โ”œโ”€โ”€ App.jsx        # React app entry point
โ”‚       โ”œโ”€โ”€ Pages/         # Inertia pages
โ”‚       โ””โ”€โ”€ Shared/        # Shared layouts/components
โ”œโ”€โ”€ webpack.config.js
โ”œโ”€โ”€ composer.json
โ”œโ”€โ”€ package.json

๐Ÿงฑ Based On

This starter is powered by:

๐Ÿ™Œ Contributing

Feel free to fork and improve. PRs welcome โ€” especially for auth scaffolding, presets, or useful utilities.

๐Ÿงช License

This project is under a MIT License