Pikanté Landing is built with Astro 6 and TypeScript. The local development experience is fast and zero-config — Astro’s dev server starts in under a second and hot-reloads components as you edit them. This guide walks you through everything needed to go from a fresh machine to a running local environment.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/luigitemu/pikante-landing/llms.txt
Use this file to discover all available pages before exploring further.
Prerequisites
Before cloning the project, make sure your machine meets the following requirements:| Requirement | Minimum version | Check |
|---|---|---|
| Node.js | >= 22.12.0 | node --version |
| npm | bundled with Node | npm --version |
package.json declares the engine requirement explicitly:
package.json
node --version returns a version older than 22.12.0, upgrade via nvm or the official Node.js installer before continuing.
Setup
This installs Astro, the React integration, Tailwind CSS v4, Lucide icons, and all other packages listed in
package.json.Open http://localhost:4321 in your browser to see the Pikanté landing page.
Available npm scripts
All commands are run from the project root:| Script | Underlying command | What it does |
|---|---|---|
npm run dev | astro dev | Starts the dev server at localhost:4321 with Hot Module Replacement |
npm run build | astro build | Compiles a production-ready static site into ./dist/ |
npm run preview | astro preview | Serves the ./dist/ build locally to verify it before deploying |
npm run astro | astro | Runs any Astro CLI command (e.g. npm run astro -- --help) |
Hot Module Replacement (HMR)
Astro’s dev server ships with HMR out of the box. When you save a.astro, .css, or TypeScript file, the browser reflects the change immediately — no manual refresh required, and without losing scroll position or component state. This applies to:
- Component files (
src/components/*.astro) — template and prop changes reload only the affected component - Global CSS (
src/styles/global.css) — style changes are injected without a full page reload - Page files (
src/pages/*.astro) — layout or import changes trigger a fast page update
TypeScript
The project’stsconfig.json extends Astro’s strict preset, which enables strict null checks, noImplicitAny, and other safety rules. Any TypeScript error in a component frontmatter or script block will surface in the terminal alongside the dev server output — no separate tsc run needed.
Astro component files (
.astro) support TypeScript directly inside the frontmatter — the --- fenced block at the top of each file. All imports, props, and local logic in that block are fully type-checked, just like a regular .ts file.VS Code extension
The project includes a.vscode/extensions.json recommendation that VS Code will surface automatically when you open the workspace:
.vscode/extensions.json
astro-build.astro-vscode) provides syntax highlighting, IntelliSense, and inline TypeScript diagnostics for .astro files. When you open the project, VS Code will prompt you to install it. You can also install it manually from the VS Code Marketplace.