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:
- Removal of any existing
dist/directory - Creation of a fresh
dist/folder - Copying of
src/pages/*,src/assets, andpublic/*intodist/ - 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.