Skip to content

Repository files navigation

DeviceView

GitHub stars License

Open-source catalog for MSP edge hardware — Peplink, Starlink, and Fortinet. Search by SKU, compare specs side-by-side, export BOMs, and keep a per-browser site brief while you explore stacks.

Source: github.com/dadishimwe/product-view

Features

  • Typed product catalog (src/data/catalog/) — no database
  • Compare up to four devices · CSV / Markdown / print PDF
  • Share links — product or compare URL with an optional note for recipients (?m=… on the link)
  • Command palette (⌘K) · favorites & recent views in localStorage
  • Site brief — requirements checklist with multi-device links
  • SEO: sitemap, product metadata, JSON-LD, favicon, and social preview images (per product + compare)

Author

Created by Dadi Ishimwe (@dadishimwe). Built with Cursor.

Getting started

npm install
npm run dev

Open http://localhost:3000.

Environment (production)

Set these on your host (e.g. Vercel → Project → Environment Variables):

# .env.local
NEXT_PUBLIC_SITE_URL=https://your-domain.com
NEXT_PUBLIC_GITHUB_REPO=dadishimwe/product-view

Production checklist (favicon, WhatsApp/link previews, smoke tests): see docs/PRODUCTION.md (Vercel steps + test list).

Social previews: product pages generate /products/[slug]/opengraph-image; compare links with ?p=slug1,slug2 use /og/compare?p=…. Requires NEXT_PUBLIC_SITE_URL on the deployed site.

Roadmap

Contributing

See CONTRIBUTING.mdspec changes require an official vendor source link in the PR.

  1. Fork the repo and create a branch.
  2. Edit catalog data in src/data/catalog/ — see src/data/CATALOG.md.
  3. Run npm run build before opening a PR.
  4. Use GitHub Issues for bugs and spec corrections.

Catalog maintenance

Product images, slugs, and specs are documented in src/data/CATALOG.md. Prefer official vendor datasheets for spec values; the app resolves datasheet URLs via src/lib/product-links.ts.

License

MIT — see LICENSE.

Deploy

Works on Vercel and any Node host that supports Next.js 16. Set NEXT_PUBLIC_SITE_URL to your production URL for canonical links and sitemap.

Maintainer checklist (GitHub)

After publishing the repo, optional but recommended:

  • Topics: msp, peplink, starlink, fortinet, nextjs, hardware-catalog
  • Labels: bug, catalog, good first issue (used by issue templates)
  • Branch protection: require CI (CI workflow) on main
  • Discussions: enable if you want Q&A separate from issues

About

MSP HARDWARE CATALOG

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages