Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@networkpro/web) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🌐 Network Pro — Web Presence

Locking Down Networks, Unlocking Confidence™
Security, Networking, Privacy — Network Pro™

🚀 Project Overview

This is the official web presence for Network Pro Strategies, a privacy-forward consultancy specializing in network engineering, information security, and public advocacy focused on cybersecurity and digital privacy.

Built with SvelteKit and deployed via Netlify.
Blog and documentation subsites built with Material for MkDocs and deployed via GitHub Pages.
All infrastructure and data flows are designed with maximum transparency, self-hosting, and user privacy in mind.

📁 Repository Structure

.
├── src/
│   ├── lib/             # Reusable components, styles, utilities
│   ├── routes/          # SvelteKit routes (+page.svelte, +page.server.js)
│   ├── hooks.client.ts  # Client-only lifecycle hooks (e.g., SW control)
│   └── app.html         # SvelteKit entry HTML with CSP/meta/bootstrap
├── tests/               # Vitest test suites
├── public/              # Static assets served at root
├── netlify.toml         # Netlify configuration
├── .github/             # CI workflows and automation
└── ...

🛠 Getting Started

📦 Environment Setup

git clone https://github.com/netwk-pro/netwk-pro.github.io.git
cd netwk-pro.github.io
cp .env.template .env
npm install

Edit .env to configure your environment mode:

ENV_MODE=dev  # Options: dev, test, ci, preview, prod

ENVMODE is used for tooling and workflows — not by SvelteKit itself.
Use VITE-prefixed env variables for runtime values.

📐 Node.js Version Management

This repo uses .nvmrc and .node-version for version consistency with tools like:

nvm
asdf
Volta
GitHub Actions

node -v     # Should match "engines" in package.json
npm -v

📜 Available Scripts

The following CLI commands are available via npm run <script> or pnpm run <script>.

🔄 Development

Script	Description
`dev`	Start development server with Vite
`preview`	Preview production build locally
`build`	Build the project with Vite
`build:netlify`	Build using Netlify CLI
`css:bundle`	Bundle and minify CSS

✅ Pre-check / Sync

Script	Description
`prepare`	Run SvelteKit sync
`check`	Run SvelteKit sync and type check with `svelte-check`
`check:watch`	Watch mode for type checks
`check:node`	Validate Node & NPM versions match package.json `engines`
`checkout`	Full local validation: check versions, test, lint, typecheck
`verify`	Alias for `checkout`

🧹 Cleanup & Maintenance

Script	Description
`delete`	Remove build artifacts and `node_modules`
`clean`	Fully reset environment and reinstall
`upgrade`	Update all dependencies via `npm-check-updates`

🧪 Testing

Script	Description
`test`	Alias for `test:all`
`test:all`	Run both client and server test suites
`test:client`	Run client tests with Vitest
`test:server`	Run server-side tests with Vitest
`test:watch`	Watch mode for client tests
`test:coverage`	Collect coverage from both client and server

🧼 Linting & Formatting

Script	Description
`lint`	Run ESLint on JS, MJS, and Svelte files
`lint:fix`	Auto-fix ESLint issues
`lint:jsdoc`	Check JSDoc annotations
`lint:css`	Run Stylelint on CSS and Svelte styles
`lint:md`	Lint Markdown content
`lint:all`	Run all linters and formatting checks
`format`	Run Prettier formatting check
`format:fix`	Auto-format code using Prettier

💡 Lighthouse / Performance

Script	Description
`lhci`	Alias for Lighthouse CI
`lighthouse`	Run local Lighthouse test and launch viewer
`lighthouse:local`	Build site, preview, and run Lighthouse locally
`lhci:run`	Run Lighthouse CI autorun

📋 Audits / Validation

Script	Description
`audit:scripts`	Check for untested utility scripts
`head:flatten`	Flatten headers for Netlify
`head:validate`	Validate headers file against project config

🔄 Lifecycle Hooks

Script	Description
`postinstall`	Ensures version check after install

🧾 License

This project is licensed under:

Creative Commons BY 4.0
Or optionally, GNU GPL v3 or later

Source code, branding, and visual assets are subject to reuse and distribution terms specified on our Legal, Copyright, and Licensing page.

🙋‍♂️ Questions?

Reach out via netwk.pro/contact, open an issue on this repo, or email us directly at contact (at) s.neteng.pro.

Designed for professionals. Hardened for privacy. Built with intent.
— Network Pro Strategies

Network Pro™, the shield logo, and the "Locking Down Networks™" slogan are trademarks of Network Pro Strategies.

Licensed under CC BY 4.0 and the GNU GPL, as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.