Reference: Repository Layout and Key Files

Overview

This section provides an end-user/developer map of the repository for the Nexora Web Agency static site. It explains how source files are organized, where key assets live, and which HTML pages correspond to routes. Understanding this layout is crucial for navigating the codebase, adding new pages or assets, and customizing the build process.

Directory Structure

The top-level project layout is defined in the README, showing the core directories and their purposes:

├── netlify.toml               # Edge configuration, security headers, and routing rules  
├── package.json               # Build orchestration scripts (build, dev)  
├── public/                    # Unprocessed static assets  
│   ├── icons/                 # SVG icons and logos  
│   └── images/                # Founder and project images  
└── src/  
    ├── assets/  
    │   ├── css/               # Global design system, resets, and utility CSS  
    │   └── js/                # Core interactive logic (e.g., multi-step form)  
    ├── components/  
    │   └── global/            # Reusable UI snippets (Header.html, Footer.html)  
    └── pages/                 # Core route pages  
        ├── index.html         # Home  
        ├── about.html         # About  
        ├── services.html      # Services hub  
        ├── projects.html      # Projects showcase  
        ├── contact.html       # Contact form  
        ├── quote.html         # 3-step quote request  
        ├── thank-you.html     # Form submission confirmation  
        ├── template.html      # Generic layout template  
        └── services/          # Nested service detail pages  
            ├── advanced-seo-optimisation.html  
            ├── custom-website-development.html  
            ├── rapid-website-templates.html  
            ├── gtm-analytics-integration.html  
            ├── ios-development.html  
            ├── android-development.html  
            ├── strategic-dashboards.html  
            ├── scalable-data-pipelines.html  
            ├── data-modelling.html  
            └── workflow-optimisation.html  

Key Files and Directories

File / Directory Path Purpose
netlify.toml /netlify.toml Defines build settings, redirects, and security/performance headers
package.json /package.json Contains build and dev scripts that assemble dist/ from source folders
public/icons /public/icons/ Raw SVG icons and logos used site-wide
public/images /public/images/ Founder portraits and project showcase images
src/assets/css /src/assets/css/ Global stylesheet files: resets, utility classes, design system (global.css, utilities.css, main.css)
src/assets/js /src/assets/js/ Vanilla JS logic, including forms.js for quote form state management
src/components/global /src/components/global/ HTML snippets for header and footer to DRY up markup
src/pages/index.html /src/pages/index.html Home page HTML
src/pages/about.html /src/pages/about.html About Us page
src/pages/services.html /src/pages/services.html Services overview hub
src/pages/projects.html /src/pages/projects.html Featured projects gallery
src/pages/contact.html /src/pages/contact.html General contact form
src/pages/quote.html /src/pages/quote.html Multi-step lead capture quote request
src/pages/thank-you.html /src/pages/thank-you.html Post-submission thank-you page
src/pages/template.html /src/pages/template.html Boilerplate template for common page components
src/pages/services/ /src/pages/services/ Detailed service pages, one per offering

Service Detail Pages (/src/pages/services/)

Each HTML file in this folder represents a specific service offering, linked from the main Services hub:

Page File
Advanced SEO Optimisation /src/pages/services/advanced-seo-optimisation.html
Custom Website Development /src/pages/services/custom-website-development.html
Rapid Website Templates /src/pages/services/rapid-website-templates.html
GTM & Analytics Integration /src/pages/services/gtm-analytics-integration.html
iOS Development & Lifecycle /src/pages/services/ios-development.html
Android Development & Lifecycle /src/pages/services/android-development.html
Strategic Dashboards & Reporting /src/pages/services/strategic-dashboards.html
Scalable Data Pipelines /src/pages/services/scalable-data-pipelines.html
Data Modelling & Architecture /src/pages/services/data-modelling.html
Workflow & Processing Optimisation /src/pages/services/workflow-optimisation.html

Build Process

The build script in package.json performs:

  1. Removal of any existing dist/ directory
  2. Creation of a fresh dist/ folder
  3. Copying of src/pages/*, src/assets, and public/* into dist/
  4. Suppression of errors if source directories are empty

This produces a fully self-contained dist/ ready for deployment. All routing is file-based; Netlify handles clean URLs and 404 fallbacks across the static HTML files.