38 answers · updated regularly

Frequently asked questions

Everything about the free @lacspace packages, the developer tools and create-lacspace-app — licensing, runtimes, TypeScript, CI, docs and more.

Getting started8

What is the Lacspace developer platform?

It's a free ecosystem for JavaScript and TypeScript developers: a library of more than 93 zero-dependency @lacspace packages, a set of standalone command-line tools, and create-lacspace-app — a CLI that scaffolds a finished Next.js app. Everything is documented at developer.lacspace.com and published openly to npm.

Are the Lacspace packages and tools really free?

Yes. Every open package and tool is published to npm under the permissive Lacspace Free Licence v1.0 — free to use, ship, modify and use commercially, with no fees, seats or usage metering. There's no paid tier waiting to switch on.

What's the difference between the packages, the tools and create-lacspace-app?

The @lacspace/* packages are libraries you import into your own code (auth, SEO, money, dates, crypto and more). The tools are standalone programs you run from your terminal (scrape a site, audit SEO, analyse a HAR, generate icons). And create-lacspace-app is a scaffolder that generates a complete Next.js project pre-wired with the best of both.

Which runtimes and platforms are supported?

The @lacspace libraries are isomorphic — they run in Node.js, the browser, edge runtimes and serverless functions, anywhere modern JavaScript runs. The command-line tools and CLIs need Node.js 20 or newer.

Do the packages add dependencies or bloat my bundle?

The @lacspace libraries are zero-dependency and tree-shakeable, so you only ship what you import and never inherit a dependency tree. The standalone tools keep dependencies minimal too — most are zero-dependency, a few build on the shared scraper engine, and only lacspace-leads drives a real browser.

ESM or CommonJS?

Both. Every library ships a dual ESM + CommonJS build with correct exports maps, so import and require both work across Node, bundlers and frameworks.

The @lacspace packages7

How many @lacspace packages are there and what do they cover?

There are more than 93 packages, grouped into kits: Core, Security, SEO, React, App & Utils, Backend, Data, Commerce & Ledger, Stock, Mail, Web, the AI Kit, the Testing Kit, the Dates & Time kit and regional payments. Between them they cover authentication, JWTs, crypto, validation, forms, SEO metadata, sitemaps, Open Graph images, money, dates, CSV/Excel, caching, rate-limiting, LLM chat and streaming, prompt engineering, token counting, RAG chunking, assertions, mocking, test fixtures and snapshots, and much more.

How do I install an @lacspace package?

With your package manager, for example npm i @lacspace/seo (or pnpm add / yarn add). Each package page on developer.lacspace.com/packages shows the exact install command, the API and copy-paste examples.

Which package should I use for a given job?

The developer handbook and the per-package reference at developer.lacspace.com/docs include a "which package for what" guide that maps common needs (auth, payments, SEO, dates, PDFs, validation) to the right package.

Are the packages production-ready?

Yes — they're versioned with semver, covered by tests, and already power Lacspace's own products and this developer platform, which dogfoods the SEO, OG, sitemap, robots and RSS packages.

Do they work with Next.js, React and other frameworks?

Yes. Because the libraries are framework-agnostic and isomorphic, they work with Next.js, Remix, Astro, SvelteKit, Express, plain Node and the browser. The React Kit adds React-specific hooks and components, and there's a dedicated Next.js helper package.

Is there documentation for each package?

Yes. Every package has a reference page, there's a full developer handbook with runnable recipes, a downloadable PDF handbook, and a live in-browser playground for several utilities — all at developer.lacspace.com/docs.

The developer tools9

What developer tools does Lacspace offer?

Twenty-seven free, keyless tools: lacspace-mcp (the tools as an MCP server for Claude, Cursor and VS Code), lacspace-leads (Google Maps lead finder), lacspace-scraper (website scraper), lacspace-monitor (change & uptime monitor), lacspace-enrich (company & contact enrichment), lacspace-extract (PDF/DOCX/HTML extraction), lacspace-sql (SQL over data files), lacspace-inspect (site audit), lacspace-cron (cron toolkit), lacspace-dotenv (.env toolkit), lacspace-webhook (webhook receiver), lacspace-har (HAR analyser), lacspace-icon (favicon/PWA generator), lacspace-http (terminal API client & .http runner), lacspace-fake (fake/seed data generator), lacspace-deps (dependency & licence auditor), lacspace-json (jq-style query, convert, validate & merge), lacspace-qr (QR-code generator), lacspace-svg (SVG optimizer & converter), lacspace-i18n (translation-file linter), lacspace-changelog (Conventional-Commits changelog & semver), lacspace-schema (JSON→Schema→TypeScript codegen), lacspace-size (bundle-size budgets), lacspace-mock (local mock REST/GraphQL server) and lacspace-license (SPDX LICENSE & header manager).

How do I run a tool without installing it?

Use npx, for example npx lacspace-inspect example.com or npx lacspace-scraper https://site.com --auto. Each tool's page at developer.lacspace.com/tools lists its commands and examples. You can also install one globally with npm i -g <tool>.

Are the tools a CLI or a library?

Both. Every tool is a command-line program and a fully-typed library, so you can run it from your terminal or import the same engine into your own code.

Which formats can the tools export?

JSON, NDJSON, CSV and Excel, with a built-in converter between all four. Several tools also emit Markdown, HTML reports, .ics calendars or images depending on the job.

Do the tools send my data anywhere?

No. The tools run on your machine, use only the open web and open data sources, and have no telemetry or accounts. Your inputs and outputs stay local.

Why is lacspace-leads local-only and not a hosted button?

lacspace-leads drives a real browser over Google Maps, so it runs on your own machine. Hosting it as a public button would breach Google's Terms of Service and can't run inside a serverless function — so it stays a one-command local tool.

Is scraping and lead-finding done responsibly?

The tools are robots.txt-aware where it matters and support polite delays, jitter, rate-limits, retries and a custom User-Agent. You're responsible for using them within each site's terms and applicable law — they're built to scrape considerately.

Can I use the tools in CI/CD pipelines?

Yes, that's a first-class use case. lacspace-inspect has --min-grade and --budget gates, lacspace-har has performance budgets, lacspace-monitor has --fail-on-change, and lacspace-dotenv has a check gate and a pre-commit hook — all exit non-zero on failure so they slot straight into CI.

create-lacspace-app6

What is create-lacspace-app?

It's a scaffolding CLI that writes a complete, production-ready Next.js 15 + Tailwind app in seconds — pre-wired with Lacspace SEO, security headers, robots.txt, a sitemap, a working contact form, a ⌘K command palette, dynamic Open Graph images and a CI workflow.

How do I scaffold a new app?

Run npx create-lacspace-app and follow the prompts, or pass a name and template directly, e.g. npx create-lacspace-app my-site --template saas. It installs dependencies and gives you a running app.

What templates are included?

Seven finished templates: personal, business, ecommerce, SaaS, blog (a real Markdown blog), docs (a real Markdown docs site) and marketplace. Each is a complete Next.js app you can deploy as-is or customise.

What comes pre-wired in a generated app?

SEO metadata and JSON-LD via @lacspace/seo, a dynamic OG image endpoint via @lacspace/og, security headers, robots.txt and a sitemap, a typed contact form with a honeypot, a ⌘K command palette, and a GitHub Actions workflow that gates on an SEO crawl grade.

Licensing & usage4

How does the Lacspace Free Licence compare to MIT?

It's permissive in the same spirit as MIT and BSD — use, modify and ship freely, including commercially — but it's Lacspace's own branded licence rather than MIT itself. In practice it imposes no more restrictions than a typical permissive open-source licence.

Is there a catch — will Lacspace start charging later?

No. The open packages and tools are free under the Free Licence, and a published version stays under the licence it shipped with. Some separate Lacspace products are commercial, but the developer packages and tools here are free.

Support & staying updated4

How do I report a bug or request a feature?

Open an issue on the GitHub repository at github.com/lacspace/npm-packages/issues. Include the package or tool name, its version, and a minimal reproduction so it can be triaged quickly.

Still have a question?

We're on GitHub

Open an issue for anything that isn't answered here — bugs, ideas or a package you wish existed.