Navosa Rugby Union Logo
Official Handover Document

Navosa Rugby Union โ€” Website Guide

A plain-English guide for managing your club website. No technical knowledge needed.

๐Ÿ“‹ Contents

  1. Understanding Your Website
  2. What's Live Right Now
  3. Adding Real Player Photos
  4. Updating News & Results
  5. Updating Fixtures & Scores
  6. Adding Gallery Photos
  7. Updating Squad Names
  8. Deploying Changes (GitHub)
  9. Facebook Photo Issue โ€” Explained
  10. Common Issues & Fixes
  11. File Reference Guide
  12. Getting Help
  13. Managing Videos & YouTube
Section 1

Understanding Your Website

Your website is made of plain files โ€” like Word documents, but for the web. There is no complicated database or login system. This makes it simple, fast, and free to host.

๐Ÿ“ navosa-rugby/ โ† This is your whole website
  ๐Ÿ“„ index.html โ† The main homepage (edit this most often)
  ๐Ÿ“„ HANDOVER-GUIDE.html โ† This document
  ๐Ÿ“„ manifest.json โ† App settings (don't edit)
  ๐Ÿ“ css/
    ๐Ÿ“„ style.css โ† All colours, fonts, layout (advanced)
  ๐Ÿ“ js/
    ๐Ÿ“„ main.js โ† Buttons, animations (don't edit)
  ๐Ÿ“ images/
    ๐Ÿ–ผ๏ธ logo.jpg โ† Club logo (replace to update)
    ๐Ÿ–ผ๏ธ favicon.ico โ† Browser tab icon
    ๐Ÿ–ผ๏ธ logo-192.png โ† App icon for phones
๐Ÿ’ก Key insight: Almost everything you'll ever need to change is inside index.html. Open it in Notepad, make your change, save, and upload. That's it.
Section 2

What's Live Right Now

Here's a summary of everything already on the site. Items marked โš ๏ธ need your club's real information to replace the placeholder content.

SectionStatusAction Needed
Club Logo & Faviconโœ… Live โ€” your actual logoNone
Club colours (Red, Black, White)โœ… LiveNone
Dark / Light Mode toggleโœ… WorkingNone
Mobile responsive layoutโœ… Working on all devicesNone
News tickerโœ… Real Navosa news headlinesUpdate as new news happens
News cards (3 stories)โœ… Real Navosa stories from Fiji TimesUpdate with each new story
Fixtures & Resultsโœ… Placeholder scores enteredโš ๏ธ Update with real 2025 results weekly
Squad namesโœ… Known player names from FRU dataโš ๏ธ Confirm accuracy with coach
Player photosโš ๏ธ "Photo Coming Soon" placeholderโš ๏ธ Add real photos (see Section 3)
Gallery photosโš ๏ธ Rugby/Fiji themed stock (not club-specific)โš ๏ธ Replace with real club photos (Section 6)
About textโœ… Real club history from Fiji TimesAdd more detail if desired
Contact formโœ… Working (shows success message)โš ๏ธ Connect to email โ€” see Section 10
Sponsorsโš ๏ธ Logo-less text placeholdersโš ๏ธ Add real sponsor logos when available
Section 3

Adding Real Player Photos

Player cards currently show a rugby ball emoji as a placeholder. Here's how to add real headshots.

Step 1 โ€” Prepare the photo

1
Take or collect a photo of the player

Square photos work best (same width and height). A phone camera in portrait mode works fine. The photo should show face and shoulders on a plain background if possible.

2
Name the file clearly

Save the photo as the player's name, all lowercase, no spaces. Example: viliame-navoka.jpg or mesake-sauroutu.jpg

3
Put it in the images folder

Copy the photo file into the images/ folder inside your website folder.

Step 2 โ€” Update the HTML

4
Open index.html in Notepad

Right-click the file โ†’ Open with โ†’ Notepad (or Notepad++)

5
Find the player card you want to update

Use Ctrl+F to search for the player's name. Example: search for Viliame Navoka

6
Replace the placeholder div with an img tag

Find this block (it will look similar for each player):

<!-- BEFORE: placeholder -->
<div class="player-card-img" style="background:#1a1a1a;display:flex...">
  <div style="text-align:center...">
    <div style="font-size:3rem;">๐Ÿ‰</div>
    <div>Photo Coming Soon</div>
  </div>
  <span class="player-number">8</span>
</div>

Replace it with:

<!-- AFTER: real photo -->
<div class="player-card-img">
  <img src="images/viliame-navoka.jpg" alt="Viliame Navoka" loading="lazy" />
  <span class="player-number">8</span>
</div>
๐Ÿ’ก Tip: The player number inside <span class="player-number"> is what shows on the card. Update it to match the player's jersey number.
โš ๏ธ Important: Always get the player's permission before publishing their photo on the website.
Section 4

Updating News Articles

The news section has 1 featured story + 3 side cards + 3 grid cards. Here's how to update them after a match or event.

1
Open index.html and search for a news title

Use Ctrl+F and search for text like Navosa open Vanua Cup to find the featured news block.

2
Update the headline text

Find the <h3> tag inside the news block and change the text between the tags:

<h3 style="...">Your new headline goes here</h3>
3
Update the date

Find the line with the date emoji: ๐Ÿ“… March 2025 and change it to the correct date.

4
Update the news tag (optional)

The red badge like <span class="news-tag">Match Report</span> โ€” change the text to match the story type.

5
Update the news ticker

Search for ticker-inner in the file. Update the text inside each <span class="ticker-item"> block with your latest headlines. Keep them short (under 15 words each).

๐Ÿ’ก Linking to Fiji Times or Fijivillage: If the story is published on fijitimes.com.fj or fijivillage.com, link to it by updating the href="..." on the news card's <a> tag.
Section 5

Updating Fixtures & Results

This is the most important regular update. Do this after every match day.

1
Open index.html and search for fixture-card

Each fixture is a block that looks like this (simplified):

<div class="fixture-card">
  <!-- HOME TEAM -->
  <div class="fixture-team">
    <img src="images/logo.jpg" ... />
    <span class="fixture-team-name">Navosa</span>
  </div>

  <!-- SCORE / DATE -->
  <div class="fixture-score">
    <div class="fixture-score-nums">22 <span class="vs">–</span> 18</div>
    <div class="fixture-meta">Sat, Mar 29 ยท Navosa Win</div>
  </div>

  <!-- AWAY TEAM -->
  <div class="fixture-team away">
    <span class="fixture-team-name">Northland</span>
    ...
  </div>

  <!-- STATUS BADGE -->
  <span class="fixture-status status-result">Win</span>
</div>

Updating a score after a match

2
Change the score numbers

Find — <span class="vs">vs</span> — (upcoming) and replace with the real score like 27 <span class="vs">–</span> 17

3
Change the status badge

Change class="fixture-status status-upcoming" to class="fixture-status status-result" and change the text from "Upcoming" to "Win" or "Loss".

4
For a loss, also add a colour override

For a loss badge, add this inline style: style="background:rgba(200,16,46,0.12);color:#C8102E"

Section 6

Adding Gallery Photos

Replace the placeholder stock photos with real Navosa club photos. The gallery shows 7 photos in a grid layout.

1
Save your photos into the images/ folder

Name them simply: gallery-1.jpg, gallery-2.jpg etc. JPG format, minimum 800px wide for good quality.

2
In index.html, search for gallery-grid

Each photo is a <div class="gallery-item">. There are 7 of them. For each one, update TWO things:

<!-- data-src = the LARGE version shown in lightbox -->
<div class="gallery-item" data-src="images/gallery-1.jpg" ...>
  <img src="images/gallery-1.jpg" 
       alt="Navosa players celebrating at Lawaqa Park" />
  <div class="gallery-item-overlay">
    <span ...>Match Day</span>
  </div>
</div>
3
Update the alt text and caption

The alt="..." text describes the photo (important for accessibility and SEO). The text inside the overlay <span> is the caption shown on hover.

๐Ÿ’ก Best sources for real Navosa photos: Check your club's Facebook page, Fiji Times photo archive at fijitimes.com.fj, Fiji Village at fijivillage.com, and match-day photographers. Always confirm you have permission to use the photo before putting it on the website.
Section 7

Updating Squad Names

Player names were sourced from the Fiji Rugby Union website and news reports. Confirm accuracy with the coach and update as needed.

1
Search for the player name you want to change

Ctrl+F โ†’ type the name โ†’ find it in the HTML

2
Update the name between the tags
<p class="player-name">Viliame Navoka</p>
<p class="player-position">Number Eight / Captain</p>
โš ๏ธ Note: Player names currently in the site were sourced from the Fiji Rugby Union website (fijirugby.com/team/navosa/). The known listed names are: Viliame Navoka, Isoa Toqabale, Sevu Tawake, Mitieli Nacibaciba, Mesake Sauroutu, Apisai Kuridavura. Others are placeholders โ€” please confirm with your team manager.
Section 8

Deploying Changes to GitHub / Vercel

Once you've made edits and saved your files, you need to upload them to GitHub so Vercel picks up the changes automatically.

Option A โ€” Using GitHub Desktop (Easiest for non-developers)

1
Download GitHub Desktop

Go to desktop.github.com and install it. Sign in with your GitHub account.

2
Open your repository

In GitHub Desktop: File โ†’ Add local repository โ†’ Select your navosa-rugby folder

3
See your changes highlighted

The left panel will show all files you changed. Click each one to see exactly what changed.

4
Commit and push

At the bottom left, type a short description like "Update fixtures โ€” Round 4 results". Click Commit to main, then click Push origin (top right).

5
Wait 1โ€“2 minutes

Vercel automatically detects the change and rebuilds your site. Your live site will update within a minute or two.

โœ… That's it! Once you do this a few times it becomes second nature. Edit file โ†’ save โ†’ GitHub Desktop โ†’ Commit โ†’ Push โ†’ done.
Section 9

Facebook Photos โ€” Why We Can't Auto-Import

This is an honest explanation of the technical limitation.

โš ๏ธ Facebook blocks automated access to photos
Facebook requires users to be logged in to view photos, and they block bots and automated tools from accessing their platform. This is intentional โ€” it's how they protect user data and enforce their Terms of Service. Any tool claiming to automatically pull photos from Facebook is either breaking their rules or not working correctly.

What you CAN do instead:

โœ…
Download photos from your Facebook page manually

Go to your Navosa Rugby Facebook page โ†’ click any photo โ†’ click the three dots (โ‹ฏ) โ†’ Download. Save to your images/ folder and follow Section 6 to add them to the gallery.

โœ…
Ask fans and photographers to send photos directly

Add a message in the gallery section โ€” it's already there: "Have real Navosa Rugby photos? Contact us or message us on Facebook."

โœ…
Future option: Embed a Facebook photo album

Facebook does allow embedding public photo albums via their official embed tool. This would show your Facebook photos directly in a section of the site. Ask your technical contact to set this up when ready.

Section 10

Common Issues & Fixes

ProblemLikely CauseFix
Photo not showingWrong filename or wrong folderCheck the image is in images/ and the filename in HTML matches exactly (case-sensitive)
Contact form doesn't send emailNo backend connectedCurrently shows success message only. To actually receive emails, connect Formspree.io (free) โ€” see below
Changes not showing on live siteNot pushed to GitHubOpen GitHub Desktop โ†’ Push origin โ†’ wait 2 minutes
Site looks broken on mobileHTML syntax errorUse validator.w3.org to check for errors
Dark mode not workingJavaScript blockedCheck browser console (F12) for errors
Gallery lightbox not openingSame JS issueCheck browser console for errors

Connecting the Contact Form to Email (Free)

1
Sign up at formspree.io (free)

Create a free account using your club email address.

2
Create a new form โ€” copy your form endpoint URL

It will look like: https://formspree.io/f/xabcdefg

3
In index.html, find the contact form tag

Change <form id="contactForm" novalidate> to:

<form id="contactForm" action="https://formspree.io/f/xabcdefg" method="POST" novalidate>
Section 11

File Reference Guide

FileWhat it doesEdit?
index.htmlThe entire homepage โ€” all content, sections, news, squad, fixturesโœ… Yes โ€” regularly
css/style.cssAll colours, fonts, sizes, layouts, dark mode๐ŸŸก Only for design changes
js/main.jsAnimations, mobile menu, theme toggle, lightbox, formโŒ Don't edit
images/logo.jpgClub logo used in nav, footer, and fixture cardsโœ… Replace to update logo
images/favicon.icoTiny icon in browser tab๐ŸŸก Replace if logo changes
manifest.jsonPWA settings for phone home screenโŒ Don't edit
HANDOVER-GUIDE.htmlThis guideโŒ Don't edit

Colour Reference

/* Club colours โ€” in css/style.css */
--clr-red:       #C8102E;   /* Primary red */
--clr-red-dark:  #9e0c22;   /* Darker red for hover */
--clr-black:     #0a0a0a;   /* Near-black */
--clr-white:     #f5f5f0;   /* Off-white */
Section 12

Getting Help

If you get stuck, here are your options:

1
Re-read the relevant section of this guide

Most common tasks are covered step-by-step above.

2
Check your change in a browser before uploading

Simply double-click index.html on your computer โ€” it will open in your browser so you can see if it looks right before going live.

3
If something breaks โ€” undo your last change

In Notepad: Ctrl+Z to undo. In GitHub Desktop: right-click the changed file โ†’ Discard changes โ€” this returns to the last working version.

4
Contact your technical person

Send them this guide along with a screenshot of the issue.

Section 13

▶ Managing the Videos Section

The site now has a full video section with a featured player, a 6-card highlights/Shorts grid, and a modal popup player. All videos play directly on the page โ€” no redirects to YouTube.

โš ๏ธ Placeholder videos: Cards 2โ€“6 currently use placeholder YouTube IDs (dQw4w9WgXcQ). Replace these with real Navosa Rugby YouTube video IDs as they become available. See steps below.

How to find a YouTube Video ID

1
Go to the YouTube video in your browser

Look at the URL in the address bar. It looks like:
https://www.youtube.com/watch?v=ABC123xyz
The Video ID is the part after v= โ€” in this case ABC123xyz

2
For YouTube Shorts

Shorts URLs look like: https://www.youtube.com/shorts/ABC123xyz
The ID is the last part: ABC123xyz

Updating a video card in index.html

3
Open index.html, search for short-card

Each card has a block like this:

<div class="short-card"
     data-vid="dQw4w9WgXcQ"
     data-title="Skipper Cup 2025 โ€” Best Tries"
     data-short="false"
     ...>

Replace data-vid="dQw4w9WgXcQ" with your real video ID.
Set data-short="true" if it's a YouTube Short (portrait video), false for regular landscape videos.

4
Update the thumbnail image

YouTube auto-generates thumbnails. Use this URL pattern (replace YOUR_ID):

https://img.youtube.com/vi/YOUR_VIDEO_ID/mqdefault.jpg

Find the <img src="https://img.youtube.com/vi/... line inside the card and update the ID there too.

5
Update the title and meta text

Inside the card body, update <p class="short-card-title">...</p> and the meta spans with the correct title, competition name, and date.

Updating the Featured (big) video

6
Search for video-facade in index.html

Update data-vid="..." and the <img src="..."> thumbnail URL the same way. Also update the title, description text, and metadata in the video-featured-info panel beside it.

โœ… Tip: When Navosa Rugby or Fiji Rugby Union posts a new match highlight on YouTube, grab the video ID and swap it in within minutes. No other technical changes needed.

Creating your own Navosa Rugby YouTube channel

7
Go to youtube.com and sign in with the club Google account

Click your profile โ†’ Create a channel โ†’ Name it "Navosa Rugby Union"

8
Upload match videos, Shorts, and player interviews

Any videos from supporters, match-day recordings, or phone clips can be uploaded. Even phone-quality vertical videos work great as YouTube Shorts.

9
Grab the video IDs and update the site

Follow steps 1โ€“5 above to add each new video to the site.

Navosa Rugby Union โ€” Vinaka vakalevu ๐Ÿ‰

This website was built for the people of Navosa. May it serve the club, the players, and the villages of the highlands well.
Keep the red and black flying high.

โ† Back to the Website