···

       
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
       
-
       
> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!

     

       
8
       
8
       
-
       


     

       
9
       
9
       
-
       
## 🚀 Project Structure

     

       
10
       
10
       
-
       


     

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

     

       
12
       
12
       
-
       


     

       
13
       
13
       
-
       
```text

     

       
14
       
14
       
-
       
/

     

       
15
       
15
       
-
       
├── public/

     

       
16
       
16
       
-
       
│   └── favicon.svg

     

       
17
       
17
       
-
       
├── src

     

       
18
       
18
       
-
       
│   ├── assets

     

       
19
       
19
       
-
       
│   │   └── astro.svg

     

       
20
       
20
       
-
       
│   ├── components

     

       
21
       
21
       
-
       
│   │   └── Welcome.astro

     

       
22
       
22
       
-
       
│   ├── layouts

     

       
23
       
23
       
-
       
│   │   └── Layout.astro

     

       
24
       
24
       
-
       
│   └── pages

     

       
25
       
25
       
-
       
│       └── index.astro

     

       
26
       
26
       
-
       
└── package.json

     

       
27
       
27
       
-
       
```

     

       
28
       
28
       
-
       


     

       
29
       
29
       
-
       
To learn more about the folder structure of an Astro project, refer to [our guide on project structure](https://docs.astro.build/en/basics/project-structure/).

     

       
30
       
30
       
-
       


     

       
31
       
31
       
-
       
## 🧞 Commands

     

       
32
       
32
       
-
       


     

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

     

       
34
       
34
       
-
       


     

       
35
       
35
       
-
       
| Command                   | Action                                           |

     

       
36
       
36
       
-
       
| :------------------------ | :----------------------------------------------- |

     

       
37
       
37
       
-
       
| `bun install`             | Installs dependencies                            |

     

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

     

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

     

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

     

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

     

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

     

       
43
       
43
       
-
       


     

       
44
       
44
       
-
       
## 👀 Want to learn more?

     

       
45
       
45
       
-
       


     

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