Skip to content

Latest commit

 

History

History
58 lines (40 loc) · 2.78 KB

File metadata and controls

58 lines (40 loc) · 2.78 KB

Rosely Documentation

Built with Starlight Netlify Status

This contains the documentation of the Rosely design system, written in Astro using the Starlight template.

It is currently hosted at Netlify. The website address is https://rosely.hellotham.com

🚀 Project Structure

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

.
├── public/
├── src/
│   ├── assets/
│   ├── content/
│   │   └── docs/
│   └── content.config.ts
├── astro.config.mjs
├── package.json
└── tsconfig.json

Starlight looks for .md or .mdx files in the src/content/docs/ directory. Each file is exposed as a route based on its file name.

Images are in src/assets/ and embedded in Markdown with a relative link.

Static assets, like favicons, are placed in the public/ directory.

🧞 Commands

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

Command Action
pnpm install Installs dependencies
pnpm dev Starts local dev server at localhost:4321
pnpm build Build your production site to ./dist/
pnpm preview Preview your build locally, before deploying
pnpm astro ... Run CLI commands like astro add, astro check
pnpm astro -- --help Get help using the Astro CLI

Deploy to Netlify

Read the full deployment guide here.

Follow the instructions to [build your site locally]((https://docs.astro.build/en/guides/deploy/#building-your-site-locally). After building, you will have a .netlify/ folder containing both Netlify Functions in the .netlify/functions-internal/ folder and Netlify Edge Functions in the.netlify/edge-functions/ folder.

To deploy your site, install the Netlify CLI and run:

netlify deploy

The Netlify Blog post on Astro and the Netlify Docs provide more information on how to use this integration to deploy to Netlify.