Getting Started

Goal

This snapshot advances Stonequay Market by teaching you to boot Symfony with Twig forms on port 8005.

Every numbered folder is a complete app. Run this stage independently, then compare it with the previous folder.

Prerequisites

Use PHP 8.2+, Composer, Node.js 20+, and Docker for MySQL stages.

Port 8005 must be free. Copy .env.example before database stages.

• PHP and Composer
• Node.js and npm
• Docker from part 4 onward

Concepts

Symfony boots an HTTP server; Twig forms drives interactive storefront UI; Tailwind styles the chrome.

Twig escapes output by default; Tailwind styles the storefront; Doctrine owns persistence and voters enforce ownership.

Walkthrough

Confirm the health endpoint and storefront home load together.

Read the example, then open the matching snapshot. The repository includes validation, CSRF, and the surrounding structure.

return $this->json(['ok' => true, 'store' => 'Stonequay Market']);

Run and verify

Enter 01-Getting-Started, composer install, copy .env, migrate, seed, build assets, and serve on port 8005.

Open http://127.0.0.1:8005. From data lessons onward, Ada and Grace use password123.

git clone https://github.com/michaeldunga1/fcc-symfony-ecommerce.git
cd fcc-symfony-ecommerce/01-Getting-Started
composer install
npm install
cp .env.example .env
php bin/console doctrine:migrations:migrate -n
php bin/console app:seed
npm run build
symfony server:start --port=8005 --no-tls
# or: php -S 0.0.0.0:8005 -t public

Troubleshooting

If the browser cannot connect, confirm the process is still listening on 8005.

For database failures, confirm Docker and the stone_NN name. Never commit .env, vendor, or node_modules.

• Read the first exception first
• Rebuild assets after Tailwind class changes
• Never commit secrets

Try this

Change the store name in config and confirm it appears on the home page.

Test a happy path and one invalid or unauthorized request.

• Make one small change
• Test it in the browser
• Compare with the next snapshot only after it works