Repository Guidelines

Project Structure & Module Organization

Root HTML:

index_new.html

about-us_new.html

gallery_new.html

testimonials_new.html

, legacy

services.html

Assets:
```
images/
```
(media),
```
css/
```
(fonts, legacy styles),
```
js/
```
(vanilla helpers),
```
favicon.ico
```
,
```
site.webmanifest
```
.
Other:
```
robots.txt
```
,
```
sitemap.xml
```
,
```
cgi-bin/
```
(unused for static pages).
Naming: lowercase, hyphen-case.
```
_new
```
denotes current iterations; when finalized, drop
```
_new
```
(e.g.,
```
index.html
```
).

Build, Test, and Development Commands

Local server:

python3 -m http.server 8080

then open

http://localhost:8080

HTML validation: validate changed pages with the W3C Validator.
Images: prefer lossless compression; keep originals in
```
images/
```
.

Coding Style & Naming Conventions

HTML: HTML5, semantic tags, 4-space indentation, wrap lines ~120 chars.
CSS: prefer external styles in
```
css/
```
; minimize inline styles.
JS: vanilla ES5/ES6 only; no frameworks. Page-specific scripts live in
```
js/
```
and should match page names (e.g.,
```
services.*.js
```
).
Filenames: lowercase, hyphen-case; group assets by type.

Testing Guidelines

Manual checks: load modified pages, verify navigation, test responsive behavior at 320/768/1024px, ensure console is error-free.
Accessibility: include descriptive
```
alt
```
text, ensure keyboard access, maintain readable color contrast.
Validation: run HTML/CSS validators on touched files before submitting.

Commit & Pull Request Guidelines

Commits: small, focused, imperative messages.

Examples:

feat: add mobile menu toggle

fix(css): correct header spacing

Pull Requests: concise description, list affected files/pages, include before/after screenshots for visual changes, and manual test notes. Link related issues/TODOs and avoid bundling unrelated changes.

Security & Configuration Tips

Static hosting only; do not add server-side logic or new
```
.php
```
files. Do not commit secrets. Favicons/manifests can be updated without server changes.

Architecture Overview

Static site (HTML + CSS + minimal JS). Keep dependencies minimal, optimize images, and favor progressive enhancement for new features.

Project Structure & Module Organization

Root HTML:

index_new.html

about-us_new.html

gallery_new.html

testimonials_new.html

, legacy

services.html

Assets:

images/

(media),

css/

(fonts, legacy styles),

js/

(vanilla helpers),

favicon.ico

site.webmanifest

Other:

robots.txt

sitemap.xml

cgi-bin/

(unused for static pages).

Naming: lowercase, hyphen-case.

_new

denotes current iterations; when finalized, drop

_new

(e.g.,

index.html

Coding Style & Naming Conventions

HTML: HTML5, semantic tags, 4-space indentation, wrap lines ~120 chars.

CSS: prefer external styles in

css/

; minimize inline styles.

JS: vanilla ES5/ES6 only; no frameworks. Page-specific scripts live in

js/

and should match page names (e.g.,

services.*.js

Filenames: lowercase, hyphen-case; group assets by type.

Testing Guidelines

Manual checks: load modified pages, verify navigation, test responsive behavior at 320/768/1024px, ensure console is error-free.

Accessibility: include descriptive

alt

text, ensure keyboard access, maintain readable color contrast.

Validation: run HTML/CSS validators on touched files before submitting.

Commit & Pull Request Guidelines

Commits: small, focused, imperative messages.

Examples:

feat: add mobile menu toggle

fix(css): correct header spacing

Pull Requests: concise description, list affected files/pages, include before/after screenshots for visual changes, and manual test notes. Link related issues/TODOs and avoid bundling unrelated changes.

Repository Guidelines

Repository Guidelines

Project Structure & Module Organization

Build, Test, and Development Commands

Coding Style & Naming Conventions

Testing Guidelines

Commit & Pull Request Guidelines

Security & Configuration Tips

Architecture Overview

Related Skills

Markdown Converter

Nano Banana Pro

1password

Repository Guidelines

Project Structure & Module Organization

Build, Test, and Development Commands

Coding Style & Naming Conventions

Testing Guidelines

Commit & Pull Request Guidelines

Security & Configuration Tips

Architecture Overview