Prerequisite

Knowledge Requirements

To get the most out of this boilerplate, it's helpful to have a comfortable understanding of the following technologies. You don't need to be an expert, but knowing your way around will make your development process much smoother.

• TypeScript & React Native: The core of the mobile application. Understanding component trees, hooks, and async programming is essential.
• PHP & Laravel: The backbone of the admin-panel. Familiarity with MVC architecture, routing, and Eloquent ORM will be very beneficial.
• Go (optional): The api-backend is written in Go. Familiarity is helpful if you plan to customize mobile API endpoints.
• Zustand & React Query: Our choices for state management. Knowledge of stores, queries, and mutations is key.

System Requirements

Before you begin, ensure your machine is ready for development.

Expo / React Native

You'll need Node.js and the Expo CLI installed on your machine.

• Node.js: v18+ (recommended: latest LTS)
• Expo CLI: Install globally with npm install -g expo-cli or use npx expo
• Recommendation: Always try to use the latest stable Expo SDK for the best performance and newest features.

Backend Environment

For running the Laravel admin-panel, a local PHP server environment is required.

• Recommended: Laravel Herd is the easiest and fastest way to get started on macOS.
• Alternative: XAMPP or other local server setups work too, but might require more configuration.

For the Go api-backend, you need Go 1.26+ installed (version specified in go.mod). See Go installation.

JavaScript Environment

You'll also need a JavaScript runtime for compiling frontend assets.

• Recommended: Bun (It's incredibly fast!).
• Alternative: Node.js is also fully supported.