Quick Start

This guide assumes you've already read the Prerequisite section and have all requirements installed.

Clone the Repository

After completing your purchase, you'll receive access to the private repository. Clone it to your local machine:

git clone https://github.com/your-username/bowlerplate.git my_app_name
cd my_app_name

Backend Setup

cd admin-panel
composer install

cp .env.example .env
php artisan key:generate

php artisan migrate --seed

pnpm install

php artisan serve

Mobile App Setup

Open a new terminal window and navigate to the mobile-app folder:

cd mobile-app
pnpm install

EXPO_PUBLIC_API_URL="http://10.0.2.2:8000" # Android Emulator
# or: "http://localhost:8000" for iOS Simulator
# or: "http://YOUR_LOCAL_IP:8000" for physical device

npx expo start
# or: pnpm run start

Verify Everything Works

Once both the backend and mobile app are running:

1. Open the mobile app - You should see the onboarding/login screen
2. Register a new account or login with the seeded credentials
3. Access the admin panel at http://localhost:8000/admin using admin@example.com / password

What's Next?

Troubleshooting

Connection Refused on Mobile

If the mobile app can't connect to the backend:

• Android Emulator: Use http://10.0.2.2:8000 instead of localhost
• iOS Simulator: localhost should work, but try 127.0.0.1 if it doesn't
• Physical Device: Use your computer's local IP (e.g., 192.168.1.x)

Database Errors

If you encounter database errors:

php artisan migrate:fresh --seed

This resets the database and re-runs all seeders.

Metro Bundler Issues

If Metro bundler has cache issues:

npx expo start --clear

This clears the Metro cache and restarts the bundler.