To get started, use our configuration tool to create and customize your new website. Once you’ve configured your site, click the Export Config button to download site-config.zip. Unzip the file — there should be a siteConfig.json, a colorsConfig.txt, and a profile-picture.jpg.
Prerequisites
Node.js - v18.17.1 or v20.3.0 or higher. (v19 is not supported).
Terminal - We’ll use the terminal to run git commands.
Git - Used to pull and push your project to GitHub.
Download the template
There are a couple ways to download the template. We recommend using GitHub’s “Use this template” feature, but you can also clone the repository directly.
Click the “Use this template” button on the top right of the page and select “Create a new repository”.
Name your repository and click “Create repository from template”.
Once the repository has been created, you can clone it to your local machine. Click the “Code” button and copy the HTTPS URL to your clipboard. Then, open your terminal and run the following command:
Navigate to the project directory and install the dependencies:
Replace the siteConfig.json file with the one you downloaded from the configuration tool.
Copy the content from colorsConfig.txt and replace the variables in src/styles/global.css.
Replace the profile-picture.jpg file in src/assets/ with the one downloaded from the configuration tool.
If you plan to use the blog feature, you can create your posts by editing the files inside of src/content/blog. Read more on how to author your content in Markdown here. If you aren’t using the blog feature, feel free to delete the blog directory in src/content, delete the src/pages/blog directory, and any mentions of the blog content in src/pages/index.astro.
If you followed the previous section “Using GitHub’s “Use this template” feature”, you can skip to deploying your site.
Clone the repository:
Navigate to the project directory:
Install the dependencies:
Remove the existing remote origin:
Create a new repository on GitHub. Do not initialize it with any files (i.e. don’t add a README, .gitignore, or a license).
Add the new repository as a remote origin:
Replace the siteConfig.json file with the one you downloaded from the configuration tool.
Copy the content from colorsConfig.txt and replace the variables in src/styles/global.css.
Replace the profile-picture.jpg file in src/assets/ with the one downloaded from the configuration tool.
If you plan to use the blog feature, you can create your posts by editing the files inside of src/content/blog. Read more on how to author your content in Markdown here. If you aren’t using the blog feature, feel free to delete the blog directory in src/content, delete the src/pages/blog directory, and any mentions of the blog content in src/pages/index.astro.