summaryrefslogtreecommitdiff
path: root/examples/non-html-pages/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'examples/non-html-pages/README.md')
-rw-r--r--examples/non-html-pages/README.md48
1 files changed, 48 insertions, 0 deletions
diff --git a/examples/non-html-pages/README.md b/examples/non-html-pages/README.md
new file mode 100644
index 000000000..354f95be3
--- /dev/null
+++ b/examples/non-html-pages/README.md
@@ -0,0 +1,48 @@
+# Astro Starter Kit: Non-HTML Pages
+
+Documentation for "Non-HTML Pages":
+
+https://docs.astro.build/en/core-concepts/astro-pages/#non-html-pages
+
+```
+npm init astro -- --template non-html-pages
+```
+
+[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/non-html-pages)
+
+> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
+
+## 🚀 Project Structure
+
+Inside of your Astro project, you'll see the following folders and files:
+
+```
+/
+├── public/
+├── src/
+│ └── pages/
+│ └── index.astro
+│ └── company.json.ts
+└── 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.
+
+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).