Version 3.3.7 (#71)

tahoni · web-flow · commit 960f76e639ae · 2025-06-01T17:23:46.000+02:00
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
@@ -0,0 +1,231 @@
+# HPSC website
+
+## Table of Contents
+
+- [Description](#description)
+- [Summary](#summary)
+- [Repository](#repository)
+- [Structure](#structure)
+- [Technology](#technology)
+- [Instructions](#instructions)
+- [Screenshots](#screenshots)
+- [License](#license)
+- [Author](#author)
+
+## Description
+
+This repository contains the source code for the Hartbeespoortdam Practical Shooting Club (HPSC) website.
+
+## Summary
+
+The [HPSC website](https://hpsc.co.za) uses modern web technologies
+to provide an informative and user-friendly platform for members and visitors.<br/>
+The primary technologies used in this project include TypeScript, SCSS, and MDX.
+
+## Repository
+
+The repository for this project is located at
+[GitHub](https://github.com/tahoni/hpsc-web-vite).
+
+Feature requests, suggestions for improvements and bugs can be
+logged using the project's [Issues](https://github.com/tahoni/hpsc-web-vite/issues) page.
+
+An overview of the project can be found at
+[https://tahoni.info/projects/hpsc-web-vite](https://www.tahoni.info/projects/hpsc-web-vite).
+
+## Structure
+
+A high-level structure of the project.
+
+```text
+├───.github
+│   └───workflows
+├───builders
+├───documentation
+│   └───screenshots
+├───public
+│   └───assets
+│       └───images
+│           ├───club
+│           ├───content
+│           ├───layout
+│           └───logos
+└───src
+    ├───assets
+    │   ├───fonts
+    │   │   └───icomoon
+    │   ├───images
+    │   │   ├───icons
+    │   │   └───ids
+    │   └───stylesheets
+    ├───components
+    │   ├───Captcha
+    │   ├───Map
+    │   ├───Sidebar
+    │   ├───Text
+    │   └───Title
+    ├───config
+    ├───constants
+    │   ├───about
+    │   └───images
+    ├───content
+    │   ├───pages
+    │   │   ├───AboutUs
+    │   │   ├───History
+    │   │   ├───Home
+    │   │   └───Links
+    │   └───posts
+    │       ├───Events
+    │       ├───Members
+    │       └───Venues
+    ├───enums
+    ├───forms
+    │   └───ContactUs
+    ├───helpers
+    ├───layout
+    │   ├───Body
+    │   ├───Breakpoints
+    │   ├───Content
+    │   ├───Footer
+    │   └───Header
+    ├───model
+    ├───pages
+    │   ├───AboutUs
+    │   ├───ContactUs
+    │   ├───Events
+    │   ├───History
+    │   ├───Home
+    │   ├───Links
+    │   ├───Members
+    │   ├───News
+    │   └───Venues
+    ├───services
+    ├───templates
+    │   └───ContactUs
+    └───utils
+```
+
+## Technology
+
+### Overview
+
+This is a React project bootstrapped using Vite with the TypeScript React template.
+
+It is written in TypeScript and uses both JSX and MDX components.
+
+Bootstrap and React Bootstrap are used for the UI/UX.<br/>
+Styling is done by SCSS stylesheets.
+
+React Router is used for page routing.
+
+### Technology Stack
+
+#### Languages:
+
+- TypeScript 5
+
+  [![TypeScript Badge](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+
+- HTML 5
+
+  [![HTML Badge](https://img.shields.io/badge/HTML-E34F26?logo=html5&logoColor=white)](https://www.w3.org/)
+
+- CSS 3
+
+  [![CSS Badge](https://img.shields.io/badge/CSS-1572B6?logo=css3)](https://www.w3.org/)
+
+#### Build Tools:
+
+- npm 10
+
+  [![npm Badge](https://img.shields.io/badge/npm-CB3837?logo=npm)](https://www.npmjs.com/)
+
+#### Frameworks:
+
+- Vite 6
+
+  [![Vite Badge](https://img.shields.io/badge/Vite-646CFF?logo=vite&logoColor=white)](https://vitejs.dev/)
+
+- React 19
+
+  [![React Badge](https://img.shields.io/badge/React-CB3837?logo=react)](https://react.dev/)
+
+#### Libraries:
+
+- Bootstrap 5
+
+  [![Bootstrap Badge](https://img.shields.io/badge/Bootstrap-7952B3?logo=bootstrap&logoColor=white)](https://getbootstrap.com/)
+
+- React Bootstrap 2
+
+  [![React Bootstrap Badge](https://img.shields.io/badge/React_Bootstrap-7952B3?logo=bootstrap&logoColor=white)](https://react-bootstrap.github.io/)
+
+- React Router 6
+
+  [![React Router Badge](https://img.shields.io/badge/React_Router-CB3837?logo=react&logoColor=white)](https://reactrouter.com/en/main)
+
+## Instructions
+
+The following commands are available in this project
+to set up the development environment
+and build the production environment.
+
+#### `npm install`
+
+This installs the dependencies.
+
+#### Environment Variables
+
+The npm key to @tahoni on GitHub needs
+to be set in the `GITHUB_TOKEN` environment variable,
+to load the `tahoni-lib-react` npm package.
+
+The Google Maps API key from Google Cloud Services needs
+to be set in the `GOOGLE_MAPS_API_KEY` environment variable,
+otherwise, the map will not be available.
+
+The Google reCAPTCHA site key from Google Cloud Services needs
+to be set in the `RECAPTCHA_V2_SITE_KEY` environment variable,
+otherwise, the CAPTCHA will break.
+
+#### `npm run dev`
+
+This runs the app in development mode.<br/>
+The page will reload if you make edits.
+
+#### `npm run build`
+
+This builds the app for production to the `dist` folder.<br/>
+Your app is ready to be deployed!
+
+#### `npm run preview`
+
+This previews the app locally in the `dist` folder.<br/>
+Use this to check if the production build looks OK in your local environment.
+
+<!-- TODO: help on how to generate sitemap -->
+
+## Screenshots
+
+<!-- TODO: update screenshots -->
+
+### History Page
+
+![History Page](./documentation/screenshots/HistoryPage.png)
+
+## License
+
+Copyright © 2025 Hartbeespoortdam Practical Shooting Club.<br/>
+All Rights Reserved.
+
+## Author
+
+**Leoni Lubbinge**
+
+- [![Website Badge](https://custom-icon-badges.demolab.com/badge/https%3A%2F%2Ftahoni.info-blue?logo=file-code)](https://www.tahoni.info)
+- [![Email Badge](https://custom-icon-badges.demolab.com/badge/leonil%40tahoni.info-blue?logo=mail)](mailto:leonil@tahoni.info)
+
+- [![Outlook Email Badge](https://custom-icon-badges.demolab.com/badge/tahoni%40outlook.com-blue.svg?logo=mail)](mailto:tahoni@outlook.com)
+- [![Gmail Email Badge](https://img.shields.io/badge/tahoni%40gmail.com-blue?logo=gmail)](mailto:tahoni@gmail.com)
+- [![GitHub Badge](https://img.shields.io/badge/Leoni_Lubbinge-blue?logo=github)](https://github.com/tahoni)
+- [![LinkedIn Badge](https://custom-icon-badges.demolab.com/badge/Leoni_Lubbinge-blue.svg?logoSource=feather&logo=linkedin)](https://www.linkedin.com/in/leoni-lubbinge-06066b16/)
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,6 +4,7 @@
 
 ### Table of Contents
 
+- [Version 3.6.7](#version-367---2025-06-01)
 - [Version 3.6.6](#version-366---2025-06-01)
 - [Version 3.6.5](#version-365---2025-05-15)
 - [Version 3.6.4](#version-364---2025-05-14)
@@ -45,7 +46,24 @@
 - [Version 3.0.1](#version-301---2024-08-27)
 - [Version 3.0.0](#version-300---2024-08-18)
 
-### [Version 3.6.6](https://github.com/tahoni/hpsc-web-vite/releases/tag/version-3.6.5) - _2025-06-01_
+### [Version 3.6.7](https://github.com/tahoni/hpsc-web-vite/releases/tag/version-3.6.7) - _2025-06-01_
+Added a link to the World Shoot 2025 apparel at Bosninja.
+Added an architecture README document.
+
+#### Enhancements and Updates
+
+- Added a link to the Bosninja IPSC Handgun World Shoot 2025 apparel for the 2025 World Shoot Handgun post.
+- Added the link to the Bosninja webpage to the constants.
+
+#### Licence and Documentation
+
+- Added an `ARCHITCTURE.md` file and copied the content of the `README.md` file there.
+
+#### Changes by
+
+@tahoni
+
+### [Version 3.6.6](https://github.com/tahoni/hpsc-web-vite/releases/tag/version-3.6.6) - _2025-06-01_
 
 Created a sitemap of the website.
 
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
@@ -2,26 +2,18 @@
 
 ## Release Notes
 
-### Version 3.6.6 - _2025-06-01_
-
-Created a sitemap of the website.
+### Version 3.6.7 - _2025-06-01_
+Added a link to the World Shoot 2025 apparel at Bosninja.
+Added an architecture README document.
 
 #### Enhancements and Updates
 
-- Added a sitemap builder to the `builder` directory that generates a sitemap and logs it to the console.
-- Created a new model class for the sitemap builder to use.
-- Split off the page info needed by the sitemap builder into a separate TypeScript file.
-- Added metadata to the pages for the sitemap, like date last updated.
-
-#### General Technical Changes
-
-- Generated a `sitemap.xml` file with all the pages of the website.
-- Referred to this file in the `robots.txt` file.
+- Added a link to the Bosninja IPSC Handgun World Shoot 2025 apparel for the 2025 World Shoot Handgun post.
+- Added the link to the Bosninja webpage to the constants.
 
-#### Dependencies
+#### Licence and Documentation
 
-- Added the `sitemap` dependency.
-- Added the `tsx` dependency as a dev dependency.
+- Added an `ARCHITCTURE.md` file and copied the content of the `README.md` file there.
 
 #### Changes by
 
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -42,7 +42,6 @@
     "react-router": "^7.5.2",
     "react-router-dom": "^7.5.2",
     "sanitize-html": "^2.14.0",
-    "sitemap": "^8.0.0",
     "sweetalert2": "^11.16.1"
   },
   "devDependencies": {
@@ -58,6 +57,7 @@
     "globals": "^15.15.0",
     "rollup-plugin-visualizer": "^5.14.0",
     "sass": "^1.85.0",
+    "sitemap": "^8.0.0",
     "tsx": "^4.19.4",
     "typescript": "~5.6.2",
     "typescript-eslint": "^8.24.0",
diff --git a/src/content/posts/Events/EventsContent.tsx b/src/content/posts/Events/EventsContent.tsx
@@ -6,13 +6,13 @@ const EventsContent = React.memo((): ReactElement => {
     WorldShootsContent,
   ];
   return (
-    <section>
+    <>
       {Contents.map(
         (Content: MemoExoticComponent<() => ReactElement>, index: number) => (
           <Content key={"events_" + index} />
         ),
       )}
-    </section>
+    </>
   );
 });
 
diff --git a/src/content/posts/Events/stories/WorldShoots/2025/WorldShoot2025Constants.tsx b/src/content/posts/Events/stories/WorldShoots/2025/WorldShoot2025Constants.tsx
@@ -32,3 +32,6 @@ export const worldShoot2025Event: VenueEvent = new VenueEvent({
   mapMode: "satellite",
   mapZoom: 17,
 });
+
+export const worldShoot2025ApparelLink: string =
+  "https://www.bosninja.co.za/product-category/ipsc-handgun-world-shoot-2025/";
diff --git a/src/content/posts/Events/stories/WorldShoots/WorldShoot.module.scss b/src/content/posts/Events/stories/WorldShoots/WorldShoot.module.scss
diff --git a/src/content/posts/Events/stories/WorldShoots/WorldShootContent.tsx b/src/content/posts/Events/stories/WorldShoots/WorldShootContent.tsx
