# Ecomm Store

PHP MVC Ecomm App w/SqliteDB

## Goals for MVP

- Avoid using JavaScript - make it usable without
- Multicurrency sats/cents
- Store Credit
- Products, carts, checkout, orders, returns/refunds.
- Subscriptions/recurring payments
- Email sign-in links, email notifications
- Light/dark theme

## Initial setup/install

Copy the `.env.example` into `.env` and edit with your preferences/credentials.

`cp .env.example .env`

`vim .env`

install composer packages using the `composer.phar` executable included in this repo

`chmod +x composer.phar`

`php composer.phar install`

Use tailwind-cli to automatically generate `/public/style.css` from `/src/style.css`

This repo includes an older `tailwindcss` binary for Apple ARM M-series processors. I could not get recent versions to work properly.

`chmod +x tailwindcss`

`./tailwindcss -i ./src/style.css -o ./public/style.css --watch`

You should only use `--watch` in development.

Tailwind (JavaScript) only generates the CSS file used in prod. We're still "avoiding JS".

## Run it

Start the local Php server from the project root, serves only the /public folder

`php -S localhost:8080 -t public`

Goto `http://localhost:8080` in your browser.

## Development

Fork it and make changes if you want! Make a PR into `main`.

### Routing

`/public/index.php` is the router, define all your urls there and assign a controller method for each route

Other app-wide defaults and vars are also set here.

### Themeing

`public/index.php` is also where all colors are defined. It uses tailwind class strings to cover both light and dark themes.

`tailwind.config.js` can be used to define a custom color pallete.

There is a bit of JS used to set a cookie that the server can read. This cookie just contains the user's browser's theme preference so the server can efficiently deliver light/dark image assets based on the theme.

### Composer

To add additional composer packages:

`php composer.phar require <package/package>`

Then commit the `composer.json`.