|
1 |
| -# Welcome to [Astro](https://astro.build) |
| 1 | +# Welcome to [Astro Devblog](https://astro-devblog.netlify.app) |
2 | 2 |
|
3 |
| -<a href="https://app.netlify.com/start/deploy?repository=https://github.com/christopher-kapic/astro-devblog"><img src="https://www.netlify.com/img/deploy/button.svg" alt="Deploy to Netlify"></a> |
4 |
| - |
5 |
| -[](https://stackblitz.com/github/withastro/astro/tree/latest/examples/basics) |
6 |
| - |
7 |
| -> 🧑🚀 **Seasoned astronaut?** Delete this file. Have fun! |
8 |
| -
|
9 |
| -## 🚀 Project Structure |
10 |
| - |
11 |
| -Inside of your Astro project, you'll see the following folders and files: |
| 3 | +Before deploying to Netlify, generate a [CockroachDB serverless database](https://cockroachlabs.cloud/) and copy the connection string. |
12 | 4 |
|
13 |
| -``` |
14 |
| -/ |
15 |
| -├── public/ |
16 |
| -│ └── favicon.ico |
17 |
| -├── src/ |
18 |
| -│ ├── components/ |
19 |
| -│ │ └── Layout.astro |
20 |
| -│ └── pages/ |
21 |
| -│ └── index.astro |
22 |
| -└── package.json |
23 |
| -``` |
24 |
| - |
25 |
| -Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name. |
26 |
| - |
27 |
| -There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components or layouts. |
28 |
| - |
29 |
| -Any static assets, like images, can be placed in the `public/` directory. |
30 |
| - |
31 |
| -## 🧞 Commands |
| 5 | +<a href="https://app.netlify.com/start/deploy?repository=https://github.com/christopher-kapic/astro-devblog"><img src="https://www.netlify.com/img/deploy/button.svg" alt="Deploy to Netlify"></a> |
32 | 6 |
|
33 |
| -All commands are run from the root of the project, from a terminal: |
| 7 | +For a more detailed set of instructions, see [this blog post](https://astro-devblog.netlify.app/article/how-to-use-astro-devblog). |
34 | 8 |
|
35 |
| -| Command | Action | |
36 |
| -| :--------------------- | :------------------------------------------------- | |
37 |
| -| `npm install` | Installs dependencies | |
38 |
| -| `npm run dev` | Starts local dev server at `localhost:3000` | |
39 |
| -| `npm run build` | Build your production site to `./dist/` | |
40 |
| -| `npm run preview` | Preview your build locally, before deploying | |
41 |
| -| `npm run astro ...` | Run CLI commands like `astro add`, `astro preview` | |
42 |
| -| `npm run astro --help` | Get help using the Astro CLI | |
| 9 | +### What is special about Astro Devblog? |
43 | 10 |
|
44 |
| -## 👀 Want to learn more? |
| 11 | +Astro devblog has several benefits for use as a developer blog. |
45 | 12 |
|
46 |
| -Feel free to check [our documentation](https://docs.astro.build) or jump into our [Discord server](https://astro.build/chat). |
| 13 | +1. Completely serverless (no need to pay for hosting with awesome tools like [Netlify](https://netlify.com)) |
| 14 | +2. Automatically post to [Medium](https://medium.com) and [Dev.to](https://dev.to/), two blogging platforms often used by developers. |
| 15 | +3. Extensibility - I have done nothing fancy with this template. If you want to change something, it shoudn't be too difficult to do so. |
| 16 | +4. Static - Astro ✨ships zero JavaScript by default✨ which means that Astro Devblog is 🔥blazingly fast🔥 |
0 commit comments