0
Fork 0
mirror of https://github.com/withastro/astro.git synced 2024-12-23 21:53:55 -05:00
astro/examples/basics/README.md
Ben Holmes 8f2f4de5dc
Feat: new just the basics template (#3206)
* feat: new just-the-basics example

* chore: update package name

* chore: update lockfile

* refactor: simplify meta tags

Co-authored-by: Nate Moore <natemoo-re@users.noreply.github.com>

* refactor: use `system-ui` for base font

Co-authored-by: Nate Moore <natemoo-re@users.noreply.github.com>

* Update examples/just-the-basics/src/components/Layout.astro

Co-authored-by: Nate Moore <natemoo-re@users.noreply.github.com>

* refactor: just-the-basics -> basics (now 10% more basic!)

* refactor: add type checking to layout prop

* nit: change "astro-text" to "text-gradient"

* refactor: simplify CSS grid

* feat: make transition easing 10% fancier

* change to text gradient because people gooootta have opinions huh

* nit: rename CSS class to "instructions"

* refactor: use ul > li for containers

* chore: update lockfile

* feat: style tweaks

Co-authored-by: Nate Moore <natemoo-re@users.noreply.github.com>
Co-authored-by: Nate Moore <nate@skypack.dev>
2022-04-26 20:37:58 -04:00

42 lines
1.6 KiB
Markdown

# Welcome to [Astro](https://astro.build)
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/starter)
> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
## 🚀 Project Structure
Inside of your Astro project, you'll see the following folders and files:
```
/
├── public/
│ └── favicon.ico
├── src/
│ ├── components/
│ │ └── Layout.astro
│ └── pages/
│ └── index.astro
└── package.json
```
Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name.
There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components or layouts.
Any static assets, like images, can be placed in the `public/` directory.
## 🧞 Commands
All commands are run from the root of the project, from a terminal:
| Command | Action |
| :---------------- | :------------------------------------------- |
| `npm install` | Installs dependencies |
| `npm run dev` | Starts local dev server at `localhost:3000` |
| `npm run build` | Build your production site to `./dist/` |
| `npm run preview` | Preview your build locally, before deploying |
## 👀 Want to learn more?
Feel free to check [our documentation](https://github.com/withastro/astro) or jump into our [Discord server](https://astro.build/chat).