Skip to content

awunjia/tinygina

Repository files navigation

TinyGina

Unisex fashion shopping site – shoes, clothes, caps, glasses, bags, gloves. Frontend-only React app with dark/light theme and mobile-responsive layout.


To start the project in dev mode: use make dev (or make dev-docker if you want Docker). Do not use make up or make fresh while coding – those serve a built copy and only change after you rebuild.


Development (Docker with hot reload)

Use Docker to run the dev server. Edit code and the UI updates in the browser without rebuilding.

docker compose up

Or: make dev-docker

Open http://localhost:5173. Change files in src/ (or styles, HTML) and the app will hot reload.

To stop: Ctrl+C, then docker compose down if you want to remove the dev container.

Development (local, no Docker)

To start the project in dev mode without Docker, use make dev:

npm install   # first time only
make dev

Or: npm run dev

Open http://localhost:5173.

Production build with Docker (no hot reload)

For a production-style run (built static files served by nginx):

docker build -f docker/Dockerfile -t tinygina .
docker run -p 3000:80 tinygina

Or: make build && make up

Open http://localhost:3000.

Makefile

From the project root:

Command Description
make dev-docker Run dev server in Docker (hot reload)
make dev Run Vite dev server locally (no Docker)
make fresh Pull base images, build image, start production container
make build Build production Docker image
make up Start production container (stops existing first)
make down Stop and remove production container
make install npm install
make clean Stop container and remove image
make clean-all clean + remove dist and node_modules
make logs Follow container logs
make help List all commands

Scripts

  • npm run dev – start Vite dev server
  • npm run build – production build to dist/
  • npm run preview – serve dist/ locally

Tech

  • React 18, Vite, React Router v6
  • CSS (variables for theme, modules for components)
  • No backend or database – mock data in src/data/

About

A dockerized react shopping app made with love

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors