Astro

How to integrate Webcore into Astro

This documentation helps you guide through the steps to integrate Webcore into your Astro project. The easiest way to get started is to use the CLI. Run the following command in your terminal and follow the prompts to install Astro with Webcore:

npm create webcore@latest

If you’d like to integrate Webcore into an existing project, you can follow the steps below to configure it manually.

Create a new Astro project

Start by creating a new Astro project by running the following command in your terminal:
Terminal window
```
npm create astro@latest
```
Add Webcore

Add Webcore as a dependency by running the following command in your terminal:
Terminal window
```
npm i webcoreui
```
Create the Configuration File

Add an empty webcore.config.scss file at the root of your project. You can read more about how you can configure your CSS using this file in the CSS Configuration section.
Configure CSS

Create a Layout.astro component for your app that can hold global CSS for the default styles. Inside the component, setup default styles and fonts by adding the following mixin:
Layout.astro
```
<!doctype html>
<html lang="en">
    <head>...</head>
    <body>
        <slot />
    </body>
</html>

<style lang="scss">
    @import 'webcoreui/styles';
    @include setup((
        fontRegular: '/fonts/Inter-Regular.woff2',
        fontBold: '/fonts/Inter-Bold.woff2'
    ));
</style>
```
Make sure the path to your fonts are correctly configured. The above example assumes your fonts are present in the public/fonts directory.

You can download the fonts Webcore uses from the public/fonts directory.
Using Components

That’s it! You’re all set to start using Webcore components in your Astro project. Import components from webcoreui/astro:
pages/index.astro
```
---
import { Alert } from 'webcoreui/astro'
import Layout from '../components/Layout.astro'
---

<Layout>
    <Alert theme="info">Webcore is ready</Alert>
</Layout>
```
Then run your dev server using the following command to view your app:
Terminal window
```
npm run dev
```

Playground

Open on Stackblitz

<- Utilities Svelte ->

Request improvement for this page

Astro

Create a new Astro project

Add Webcore

Create the Configuration File

Configure CSS

Using Components

Playground