Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion src/pages/en/core-concepts/project-structure.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ i18nReady: true
---
import FileTree from '~/components/FileTree.astro'

Your new Astro project generated from the `create-astro` CLI wizard already includes some files and folders. Others, you will create yourself and add to Astro's existing file structure.
Your new Astro project generated from the `create astro` CLI wizard already includes some files and folders. Others, you will create yourself and add to Astro's existing file structure.

Here's how an Astro project is organized, and some files you will find in your new project.

Expand Down
6 changes: 2 additions & 4 deletions src/pages/en/getting-started.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ Visit [astro.new](https://astro.new/) and choose from a variety of templates to

## Start your first project

Get a new Astro project up and running locally with our helpful `create-astro` CLI wizard!
Get a new Astro project up and running locally with our helpful `create astro` CLI wizard!

<PackageManagerTabs>
<Fragment slot="npm">
Expand All @@ -60,9 +60,7 @@ Get a new Astro project up and running locally with our helpful `create-astro` C
</Fragment>
</PackageManagerTabs>

Our [Installation Guide](/en/install/auto/) has full, step-by-step instructions for installing Astro using your favorite package manager.


Our [Installation Guide](/en/install/auto/) has full, step-by-step instructions for installing Astro using our CLI wizard, creating a new project from an existing Astro GitHub repository, and for installing Astro manually.


## Learn Astro
Expand Down
8 changes: 4 additions & 4 deletions src/pages/en/guides/migrate-to-astro/from-docusaurus.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -43,22 +43,22 @@ When you rebuild your Docusaurus site in Astro, you will notice some important d

To convert a Docusaurus documentation site to Astro, start with our official docs theme starter template, or explore more community docs themes in our [theme showcase](https://astro.build/themes/docs/).

You can pass a `--template` argument to the `create-astro` command to start a new Astro project from any existing Astro repository on GitHub:
You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm create astro -- --template withastro/docs
npm create astro@latest -- --template docs
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm create astro --template withastro/docs
pnpm create astro@latest --template docs
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn create astro --template withastro/docs
yarn create astro --template docs
```
</Fragment>
</PackageManagerTabs>
Expand Down
8 changes: 4 additions & 4 deletions src/pages/en/guides/migrate-to-astro/from-eleventy.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,22 +36,22 @@ When you rebuild your Eleventy (11ty) site in Astro, you will notice some import

To convert an Eleventy blog to Astro, start with our blog theme starter template, or explore more community blog themes in our [theme showcase](https://astro.build/themes/).

You can pass a `--template` argument to the `create-astro` command to start a new Astro project from any existing Astro repository on GitHub:
You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm create astro -- --template withastro/blog
npm create astro@latest -- --template blog
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm create astro --template withastro/blog
pnpm create astro@latest --template blog
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn create astro --template withastro/blog
yarn create astro --template blog
```
</Fragment>
</PackageManagerTabs>
Expand Down
8 changes: 4 additions & 4 deletions src/pages/en/guides/migrate-to-astro/from-gatsby.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -38,22 +38,22 @@ When you rebuild your Gatsby site in Astro, you will notice some important diffe

To convert a Gatsby blog to Astro, start with our official blog theme starter template, or explore more community blog themes in our [theme showcase](https://astro.build/themes/).

You can pass a `--template` argument to the `create-astro` command to start a new Astro project from any existing Astro repository on GitHub:
You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm create astro -- --template withastro/blog
npm create astro@latest -- --template blog
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm create astro --template withastro/blog
pnpm create astro@latest --template blog
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn create astro --template withastro/blog
yarn create astro --template blog
```
</Fragment>
</PackageManagerTabs>
Expand Down
8 changes: 4 additions & 4 deletions src/pages/en/guides/migrate-to-astro/from-gridsome.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,22 +36,22 @@ When you rebuild your Gridsome site in Astro, you will notice some important dif

To convert a Gridsome blog to Astro, start with our blog theme starter template, or explore more community blog themes in our [theme showcase](https://astro.build/themes/).

You can pass a `--template` argument to the `create-astro` command to start a new Astro project from any existing Astro repository on GitHub:
You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm create astro -- --template withastro/blog
npm create astro@latest -- --template blog
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm create astro --template withastro/blog
pnpm create astro@latest --template blog
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn create astro --template withastro/blog
yarn create astro --template blog
```
</Fragment>
</PackageManagerTabs>
Expand Down
8 changes: 4 additions & 4 deletions src/pages/en/guides/migrate-to-astro/from-hugo.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,22 +36,22 @@ When you rebuild your Hugo site in Astro, you will notice some important differe

To convert a Hugo blog to Astro, start with our blog theme starter template, or explore more community blog themes in our [theme showcase](https://astro.build/themes/).

You can pass a `--template` argument to the `create-astro` command to start a new Astro project from any existing Astro repository on GitHub:
You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm create astro -- --template withastro/blog
npm create astro@latest -- --template blog
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm create astro --template withastro/blog
pnpm create astro@latest --template blog
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn create astro --template withastro/blog
yarn create astro --template blog
```
</Fragment>
</PackageManagerTabs>
Expand Down
8 changes: 4 additions & 4 deletions src/pages/en/guides/migrate-to-astro/from-jekyll.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -34,22 +34,22 @@ When you rebuild your Jekyll site in Astro, you will notice some important diffe

To convert a Jekyll blog to Astro, start with our blog theme starter template, or explore more community blog themes in our [theme showcase](https://astro.build/themes/).

You can pass a `--template` argument to the `create-astro` command to start a new Astro project from any existing Astro repository on GitHub:
You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm create astro -- --template withastro/blog
npm create astro@latest -- --template blog
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm create astro --template withastro/blog
pnpm create astro@latest --template blog
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn create astro --template withastro/blog
yarn create astro --template blog
```
</Fragment>
</PackageManagerTabs>
Expand Down
8 changes: 4 additions & 4 deletions src/pages/en/guides/migrate-to-astro/from-nextjs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -41,22 +41,22 @@ When you rebuild your Next.js site in Astro, you will notice some important diff

To convert a Next.js blog to Astro, start with our official blog theme starter template, or explore more community blog themes in our [theme showcase](https://astro.build/themes/).

You can pass a `--template` argument to the `create-astro` command to start a new Astro project from any existing Astro repository on GitHub:
You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm create astro -- --template withastro/blog
npm create astro@latest -- --template blog
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm create astro --template withastro/blog
pnpm create astro@latest --template blog
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn create astro --template withastro/blog
yarn create astro --template blog
```
</Fragment>
</PackageManagerTabs>
Expand Down
8 changes: 4 additions & 4 deletions src/pages/en/guides/migrate-to-astro/from-nuxtjs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,22 +36,22 @@ When you rebuild your Nuxt site in Astro, you will notice some important differe

To convert a Nuxt blog to Astro, start with our official blog theme starter template, or explore more community blog themes in our [theme showcase](https://astro.build/themes/).

You can pass a `--template` argument to the `create-astro` command to start a new Astro project from any existing Astro repository on GitHub:
You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm create astro -- --template withastro/blog
npm create astro@latest -- --template blog
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm create astro --template withastro/blog
pnpm create astro@latest --template blog
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn create astro --template withastro/blog
yarn create astro --template blog
```
</Fragment>
</PackageManagerTabs>
Expand Down
8 changes: 4 additions & 4 deletions src/pages/en/guides/migrate-to-astro/from-pelican.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,22 +32,22 @@ When you rebuild your Pelican site in Astro, you will notice some important diff

To convert a Pelican documentation site to Astro, start with our official blog theme starter template, or explore more community blog themes in our [theme showcase](https://astro.build/themes/).

You can pass a `--template` argument to the `create-astro` command to start a new Astro project from any existing Astro repository on GitHub:
You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm create astro -- --template withastro/docs
npm create astro@latest -- --template docs
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm create astro --template withastro/docs
pnpm create astro@latest --template docs
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn create astro --template withastro/docs
yarn create astro --template docs
```
</Fragment>
</PackageManagerTabs>
Expand Down
8 changes: 4 additions & 4 deletions src/pages/en/guides/migrate-to-astro/from-sveltekit.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -37,22 +37,22 @@ When you rebuild your SvelteKit site in Astro, you will notice some important di

To convert a SvelteKit blog to Astro, start with our blog theme starter template, or explore more community blog themes in our [theme showcase](https://astro.build/themes/).

You can pass a `--template` argument to the `create-astro` command to start a new Astro project from any existing Astro repository on GitHub:
You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm create astro -- --template withastro/blog
npm create astro@latest -- --template blog
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm create astro --template withastro/blog
pnpm create astro@latest --template blog
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn create astro --template withastro/blog
yarn create astro --template blog
```
</Fragment>
</PackageManagerTabs>
Expand Down
8 changes: 4 additions & 4 deletions src/pages/en/guides/migrate-to-astro/from-vuepress.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -34,22 +34,22 @@ When you rebuild your VuePress site in Astro, you will notice some important dif

To convert a VuePress documentation site to Astro, start with our official docs theme starter template, or explore more community docs themes in our [theme showcase](https://astro.build/themes/docs/).

You can pass a `--template` argument to the `create-astro` command to start a new Astro project from any existing Astro repository on GitHub:
You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm create astro -- --template withastro/docs
npm create astro@latest -- --template docs
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm create astro --template withastro/docs
pnpm create astro@latest --template docs
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn create astro --template withastro/docs
yarn create astro --template docs
```
</Fragment>
</PackageManagerTabs>
Expand Down
8 changes: 4 additions & 4 deletions src/pages/en/guides/migrate-to-astro/from-wordpress.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,22 +36,22 @@ When you rebuild your WordPress site in Astro, you will notice some important di

To convert a WordPress blog to Astro, start with our blog theme starter template, or explore more community blog themes in our [theme showcase](https://astro.build/themes).

You can pass a `--template` argument to the `create-astro` command to start a new Astro project from any existing Astro repository on GitHub:
You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm create astro -- --template withastro/blog
npm create astro@latest -- --template blog
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm create astro --template withastro/blog
pnpm create astro@latest --template blog
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn create astro --template withastro/blog
yarn create astro --template blog
```
</Fragment>
</PackageManagerTabs>
Expand Down
2 changes: 1 addition & 1 deletion src/pages/en/guides/troubleshooting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -127,7 +127,7 @@ const myFeaturedPost = posts.find(post => post.file.includes(pathToMyFeaturedPos

### Using Astro with Yarn 2+ (Berry)

Yarn 2+, a.k.a. Berry, uses a technique called [Plug'n'Play (PnP)](https://yarnpkg.com/features/pnp) to store and manage Node modules, which can [cause problems](https://github.com/withastro/astro/issues/3450) while initializing a new Astro project using `create-astro` or while working with Astro. A workaround is to set the [`nodeLinker` property](https://yarnpkg.com/configuration/yarnrc#nodeLinker) in `.yarnrc.yml` to `node-modules`:
Yarn 2+, a.k.a. Berry, uses a technique called [Plug'n'Play (PnP)](https://yarnpkg.com/features/pnp) to store and manage Node modules, which can [cause problems](https://github.com/withastro/astro/issues/3450) while initializing a new Astro project using `create astro` or while working with Astro. A workaround is to set the [`nodeLinker` property](https://yarnpkg.com/configuration/yarnrc#nodeLinker) in `.yarnrc.yml` to `node-modules`:

```yaml title=".yarnrc.yml"
nodeLinker: "node-modules"
Expand Down
Loading