Skip to content
/ new-astro-repo Public template

Starter project based on Astro, Shoelace and Lit

License

Notifications You must be signed in to change notification settings

gongfudev/new-astro-repo

Repository files navigation

‹new-astro-repo›

Starter project with Astro, Shoelace and Lit.

Status

👾 Tinkering. Work-in-progress.

Components

Component Description
‹TODO› Description of the ‹TODO› component

🚀 Project Structure

The source code of the layouts lives in the src/pages/ subfolder.

At its root, this repository is an Astro publication, that is automatically published by Vercel on commits, to allow browsing the layout templates online.

You can preview the Astro publication by running npm start after installing the deps. The publication was generated by running the following command:

npm create astro@latest -- --template basics

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

/
├── public/
│   └── favicon.svg
├── src/
│   ├── components/
│   │   └── Card.astro
│   ├── layouts/
│   │   └── 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.

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:4321
npm run build Build your production site to ./dist/
npm run preview Preview your build locally, before deploying
npm run astro ... Run CLI commands like astro add, astro check
npm run astro -- --help Get help using the Astro CLI

📚 Learn more about Astro

Check the documentation of Astro or jump into our Discord server.

License

Distributed under the Apache-2.0 license. See LICENSE for details.