castellonsoft Logo castellonsoft
Docs / Getting Started

Getting Started

Welcome to the castellonsoft documentation! This guide will help you get your project up and running in minutes.

Installation

First, clone the repository to your local machine:

git clone https://github.com/CastellonSft/website.git
cd website

Next, install the dependencies:

npm install

Running Locally

Start the development server:

npm run dev

Open your browser and navigate to http://localhost:4321 to see the site in action.

Project Structure

Here’s a quick look at how the project is organized:

src/
├── components/        # Reusable components
│   ├── blog/          # Blog & Portfolio cards/items
│   ├── common/        # Shared global tools
│   ├── islands/       # Interactive React components
│   ├── layout/        # Structural atoms (Section, Grid)
│   ├── sections/      # Marketing blocks (Hero, Features)
│   └── ui/            # Basic UI parts (Button, Badge)
├── content/           # Content Collections (Blog, Docs)
├── layouts/           # Page wrappers
├── pages/             # File-based routing
├── styles/            # CSS & Tailwind setup
└── site.config.ts     # Global settings

Customization

Theming

You can easily customize the primary brand color and other site settings in src/site.config.ts.

// src/site.config.ts
export const siteConfig = {
  name: "castellonsoft",
  description: "Premium Astro Boilerplate",
  primaryColor: "#00008B", // Update this to your brand color
};

To update the header links, modify src/components/Header.astro.

Deployment

This Boilerplate is ready to deploy to Vercel, Netlify, or any static hosting provider. Just run:

npm run build

This will generate a dist folder with your static site.

Next Steps

Check out the Components Guide to see the included premium components in action and learn how to customize them.

Next Components