Skip to main content
Get the Chitagá Tech platform running on your local machine in just a few minutes.

​
Prerequisites

Before you begin, ensure you have the following installed:
  • Node.js 18+ (Download)
  • npm or your preferred package manager
  • A code editor (VS Code recommended)
  • Git for version control

​
Installation

1

Clone the repository

Clone the Chitagá Tech repository to your local machine:
git clone https://github.com/yamiddevofic/chitaga-tech.git
cd chitaga-tech
2

Install dependencies

Install all required packages using npm:
npm install
This will install:
  • Astro 5.17.1 - The core framework
  • React 19.2.4 - For interactive components
  • Tailwind CSS 4.2.1 - For styling
  • Framer Motion 12.34.4 - For animations
3

Start the development server

Launch the local development server:
npm run dev
The site will be available at http://localhost:4321
4

Open in your browser

Navigate to http://localhost:4321 to see the Chitagá Tech platform running locally.
If you need to access the dev server from another device on your network, use npm run dev:host instead.

​
Project Structure

Once installed, you’ll find this structure: 
chitaga-tech/
├── public/              # Static assets
│   ├── favicon.ico
│   ├── og-image.png
│   └── parque.jpg
├── src/
│   ├── components/      # Astro & React components
│   │   ├── hero.astro
│   │   ├── about.astro
│   │   ├── services.astro
│   │   ├── projects.astro
│   │   ├── contact.astro
│   │   └── ScrollAnimation.jsx
│   ├── layouts/         # Page layouts
│   │   └── Layout.astro
│   ├── pages/           # Route pages
│   │   └── index.astro
│   └── styles/          # Global styles
│       └── global.css
├── astro.config.mjs     # Astro configuration
└── package.json         # Dependencies and scripts

​
Your First Customization

Let’s customize the hero section to see the platform in action.
1

Open the hero component

Open src/components/hero.astro in your editor.
2

Modify the title

Find the default props around line 14-16:
const {
    title = "Tu futuro no debería depender de irte de Chitagá",
    subtitle = "Somos profesionales chitagüenses...",
    // ...
} = Astro.props;
Change the title to something personal!
3

See the changes

Save the file. Astro’s dev server will hot-reload, and you’ll see your changes instantly at localhost:4321.
All components support dark mode out of the box. Click the theme toggle button in the bottom-right corner to test it!

​
Available Scripts

npm run dev
# Start dev server at localhost:4321

npm run dev:host
# Start dev server accessible from network

​
Next Steps

Now that you have Chitagá Tech running locally, explore these resources:

Component Library

Learn about all available components

Styling Guide

Customize colors, fonts, and theme

About the Project

Understand Chitagá Tech’s mission

Contributing

Help improve the platform

​
Troubleshooting

If port 4321 is occupied, Astro will automatically try the next available port (4322, 4323, etc.). Check your terminal output for the actual URL.
Delete node_modules and package-lock.json, then run npm install again:
rm -rf node_modules package-lock.json
npm install
Hard refresh your browser (Ctrl+Shift+R on Windows/Linux, Cmd+Shift+R on Mac) or clear the cache.
Make sure you have the Astro extension installed. Install it from the Extensions marketplace: “Astro” by Astro.
If you encounter any issues not covered here, check the GitHub repository for open issues or create a new one.

Build docs developers (and LLMs) love

Get started for freeTalk to us