# TEST THE REAL PROJECT — Local Testing Guide
### No coding. No terminal typing. Nothing goes on the public internet.

This is the **real** Freedom Fitness project — the actual frontend, the
actual backend, the actual database, the actual Admin Dashboard. Nothing
here is a demo or mockup. This guide runs it **on your own computer only**
— not on the internet, not reachable by anyone but you.

---

## Why this is the only way to test the real thing, and why it's still simple

The real project has a part that needs to be *running* (the backend) for
anything to actually work — logins, saving a trainer, buying a
membership, all of it. Something, somewhere, has to keep that part
switched on while you test.

There are only two possible "somewheres": a cloud host on the internet, or
your own computer. Since you don't want to go on the internet yet, that
leaves your computer — which is actually the better choice for testing
anyway, because nothing you do is visible to anyone else.

The only unavoidable requirement is that **your computer needs one piece
of free software installed first, called Node.js** — this is what
actually runs the backend. That's not coding; it's a normal installer,
exactly like installing Zoom or Adobe Reader: download it, double-click
it, click "Next" a few times. You do this once, ever.

After that one-time install, testing the project again in the future is
just double-clicking a single file. No terminal, no typing commands.

---

## Step 1 — Install Node.js (one-time, ~5 minutes)

1. Go to **[nodejs.org](https://nodejs.org)**
2. Click the button that says **LTS** (it's the recommended version)
3. Open the downloaded file and click through the installer using all the
   default options (keep clicking "Next" / "Continue" / "Install")
4. When it's done, you can close the installer. You will **never see a
   terminal or type anything** during this — it's a normal app install.

*(If Node.js is already installed on your computer, skip this step entirely.)*

---

## Step 2 — Double-click one file to start everything

In the project folder, you'll find two launcher files — use the one that
matches your computer:

| Your computer | Double-click this file |
|---|---|
| Windows | `start-windows.bat` |
| Mac | `start-mac.command` |

**What happens when you double-click it:**
- A window opens and does all the setup for you automatically (the very
  first time only, this can take a couple of minutes — after that, it's fast)
- It starts the real backend
- It starts the real website
- **Your browser opens automatically** to the real, live-on-your-computer website

You'll see log windows appear (black windows with text scrolling) — that's
normal, that's just the backend and website quietly running. Don't close
them while you're testing; you can minimize them.

**Mac only, one extra note:** the first time you double-click
`start-mac.command`, macOS may show a security warning since the file
didn't come from the App Store. If that happens: right-click the file →
**Open** → then click **Open** again on the popup. You only need to do
this once.

---

## Step 3 — Test everything

Your browser will already be open to:
```
http://localhost:5500/index.html
```
This is the real homepage. Click through it — plans, trainers, gallery,
contact form, everything.

For the Admin Dashboard, go to:
```
http://localhost:5500/admin/index.html
```
Log in with:
- **Email:** `admin@freedomfitnessjanakpur.com`
- **Password:** `change_this_password_immediately`

(These are just starter test credentials, automatically set up for you —
not a security concern, since this is only running on your own computer
right now, not the internet.)

From here you can test the exact same checklist as before, and this time
it's all real:
- Homepage, navigation, membership plans, trainers, gallery, contact form,
  testimonials, FAQs
- Editing a price in the Admin Dashboard → switch to the website tab →
  see the new price update for real, coming from the real database
- Adding/editing/deleting trainers, gallery photos, FAQs
- "Join Now" button on each membership plan scrolling to the enquiry form
- Contact form submissions appearing in the Admin Dashboard's Messages tab
- Mobile responsiveness — resize your browser window narrower, or open
  `http://localhost:5500/index.html` on your phone if it's on the same
  Wi-Fi as your computer

---

## Step 4 — When you're done testing

Just close the black log windows (or restart your computer). Nothing was
installed anywhere but your own machine, and nothing was ever visible to
anyone on the internet.

You can run `start-windows.bat` / `start-mac.command` again anytime you
want to test again — after the first time, it starts in a few seconds.

---

## If something goes wrong

| Problem | What it means |
|---|---|
| "Node.js is not installed" message appears | Go back to Step 1 |
| Browser shows "can't connect" | Wait a few more seconds and refresh — the very first startup takes longer while it installs things |
| Mac won't open the file, security warning | See the note in Step 2 (right-click → Open) |
| You made a change in Admin but don't see it on the website | Make sure you're looking at the same browser tab/window that opened automatically, and try refreshing |