Routing

Goal

This snapshot advances Cobblecart Market by teaching you to register shop routes for catalog, cart, and health.

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

Prerequisites

Use Ruby 3.2+, Bundler, Node.js 20+, and Docker for Postgres stages.

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

• Ruby and Bundler
• Node.js and npm
• Docker from part 4 onward

Concepts

Named routes keep template links stable when URLs change.

Turbo keeps interactive UI on the server; Tailwind styles the storefront; Active Record owns persistence and authorization checks.

Walkthrough

Add home, about, health, and placeholder catalog routes.

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

root "store#home"
get "/health", to: "store#health"

Run and verify

Enter 02-Routing, bundle install, copy .env.example, migrate, seed, and boot Puma on port 3010.

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

git clone https://github.com/michaeldunga1/fcc-rails-ecommerce.git
cd fcc-rails-ecommerce/02-Routing
bundle install
npm install
cp .env.example .env
bin/rails db:prepare
bin/rails server -b 0.0.0.0 -p 3010

Troubleshooting

A 404 usually means the verb or URI does not match the router table.

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

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

Try this

Add a named /contact route and link it from the layout.

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