···

       
1
       
1
       
-
       
# Astro Starter Kit: Basics

     

       
2
       
2
       
-
       


     

       
3
       
3
       
-
       
```sh

     

       
4
       
4
       
-
       
bun create astro@latest -- --template basics

     

       
5
       
5
       
-
       
```

     

       
6
       
6
       
-
       


     

       
7
       
7
       
-
       
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/basics)

     

       
8
       
8
       
-
       
[![Open with CodeSandbox](https://assets.codesandbox.io/github/button-edit-lime.svg)](https://codesandbox.io/p/sandbox/github/withastro/astro/tree/latest/examples/basics)

     

       
9
       
9
       
-
       
[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/withastro/astro?devcontainer_path=.devcontainer/basics/devcontainer.json)

     

       
10
       
10
       
-
       


     

       
11
       
11
       
-
       
> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!

     

       
12
       
12
       
-
       


     

       
13
       
13
       
-
       
![just-the-basics](https://github.com/withastro/astro/assets/2244813/a0a5533c-a856-4198-8470-2d67b1d7c554)

     

       
14
       
14
       
-
       


     

       
15
       
15
       
-
       
## 🚀 Project Structure

     

       
1
       
1
       
+
       
# Comet landing page

     

       
16
       
2
       
 
       


     

       
17
       
17
       
-
       
Inside of your Astro project, you'll see the following folders and files:

     

       
18
       
18
       
-
       


     

       
19
       
19
       
-
       
```text

     

       
20
       
20
       
-
       
/

     

       
21
       
21
       
-
       
├── public/

     

       
22
       
22
       
-
       
│   └── favicon.svg

     

       
23
       
23
       
-
       
├── src/

     

       
24
       
24
       
-
       
│   ├── layouts/

     

       
25
       
25
       
-
       
│   │   └── Layout.astro

     

       
26
       
26
       
-
       
│   └── pages/

     

       
27
       
27
       
-
       
│       └── index.astro

     

       
28
       
28
       
-
       
└── package.json

     

       
29
       
29
       
-
       
```

     

       
30
       
30
       
-
       


     

       
31
       
31
       
-
       
To learn more about the folder structure of an Astro project, refer to

     

       
32
       
32
       
-
       
[our guide on project structure](https://docs.astro.build/en/basics/project-structure/).

     

       
33
       
33
       
-
       


     

       
34
       
34
       
-
       
## 🧞 Commands

     

       
35
       
35
       
-
       


     

       
36
       
36
       
-
       
All commands are run from the root of the project, from a terminal:

     

       
37
       
37
       
-
       


     

       
38
       
38
       
-
       
| Command               | Action                                           |

     

       
39
       
39
       
-
       
| :-------------------- | :----------------------------------------------- |

     

       
40
       
40
       
-
       
| `bun install`         | Installs dependencies                            |

     

       
41
       
41
       
-
       
| `bun dev`             | Starts local dev server at `localhost:4321`      |

     

       
42
       
42
       
-
       
| `bun build`           | Build your production site to `./dist/`          |

     

       
43
       
43
       
-
       
| `bun preview`         | Preview your build locally, before deploying     |

     

       
44
       
44
       
-
       
| `bun astro ...`       | Run CLI commands like `astro add`, `astro check` |

     

       
45
       
45
       
-
       
| `bun astro -- --help` | Get help using the Astro CLI                     |

     

       
46
       
46
       
-
       


     

       
47
       
47
       
-
       
## 👀 Want to learn more?

     

       
48
       
48
       
-
       


     

       
49
       
49
       
-
       
Feel free to check [our documentation](https://docs.astro.build) or jump into

     

       
50
       
50
       
-
       
our [Discord server](https://astro.build/chat).

     

       
3
       
3
       
+
       
Nothing special here for now.