Skip to main content

Prerequisites

Node.js 18+

Download from nodejs.org. Version 18 or higher is required.

npm

Included with Node.js. Used to install dependencies and run scripts.

Git

Download from git-scm.com. Used to clone the repository.

Get started

1

Clone the repository

git clone https://github.com/marcoszinga94/Argentista.git
cd Argentista
2

Install dependencies

npm install
This installs all runtime and development dependencies, including Astro, React, and Tailwind CSS.
3

Start the development server

npm run dev
The dev server starts at http://localhost:4321. Astro watches for file changes and hot-reloads automatically.
Astro’s default dev server port is 4321. If that port is in use, Astro will pick the next available port and print the actual URL to the terminal.

Other commands

Build for production

Run a full TypeScript type check and then build optimized static output:
npm run build
Always run the build before committing. It catches TypeScript errors that the dev server may not surface.

Preview the production build

After building, serve the output locally to verify it looks correct before deploying:
npm run preview

Run tests

npm run test
See the testing guide for details on writing and running tests.

Project layout

src/
├── components/      # React (.jsx) and Astro (.astro) UI components
├── layouts/         # Shared page wrapper (Layout.astro)
├── pages/           # File-based routes
│   ├── index.astro       → /
│   ├── dolar.astro       → /dolar
│   └── inflacion.astro   → /inflacion
├── styles/          # Global CSS
├── test/            # Vitest setup (setup.ts)
├── Icons/           # SVG icon assets
└── basic.test.ts    # Example test file
astro.config.mjs
vitest.config.ts
tsconfig.json
package.json
DirectoryPurpose
src/components/React (.jsx) and Astro (.astro) UI components
src/layouts/Shared page wrapper layouts
src/pages/File-based routes — each .astro file becomes a URL
src/styles/Global CSS loaded site-wide
src/test/Vitest setup and helpers
src/Icons/SVG icon assets

Build docs developers (and LLMs) love