You are opening a small online store API called Pionia Shop. This step creates the empty project on your machine — about five minutes.

What you will learn

  • Install the official app template with Composer
  • Recognize the folders you will use in every later step
Before you start

Check your tools first

Terminalbash
php -v
composer --version

PHP must report 8.5 or newer. If either command is missing or PHP is older, complete the setup guide first.

Create pionia-shop

Terminalbash
composer create-project pionia/pionia-app pionia-shop
cd pionia-shop
composer check-platform-reqs

You now have:

PathRole
services/Where ProductService will live
switches/API version wiring (MainSwitch)
environment/.env and settings.ini
database/migrations/Schema changes
public/Web entry

Set the store name in environment/.env:

Code exampleenv
APP_NAME=Pionia Shop
PORT=8000

Common mistakes

  • Creating the project in a nested folder you did not intend — check pwd after cd
  • Skipping cd pionia-shop — later php pionia commands must run from the app root