Toolbox

Name	Status
Woodpecker Pipeline
Dev environment
Prod environment

WIP

Stack

• Astro
• Bun
• Dbmate

---

bun create astro@latest -- --template basics

🧑‍🚀 Seasoned astronaut? Delete this file. Have fun!

🚀 Project Structure

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

/
├── public/
│   └── favicon.svg
├── src
│   ├── assets
│   │   └── astro.svg
│   ├── components
│   │   └── Welcome.astro
│   ├── layouts
│   │   └── Layout.astro
│   └── pages
│       └── index.astro
└── package.json

To learn more about the folder structure of an Astro project, refer to our guide on project structure.

🧞 Commands

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

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

The development shell also provides Chromium for Playwright:

nix develop
just integration-test

The integration test builds the production Astro server and opens the home page with Playwright. It uses the Chromium binary from the Nix shell instead of downloading a browser from the Playwright CDN. The server runs on port 4323 with server reuse disabled so a stale process cannot make the test pass. The production server command uses POSIX inline environment variables and is intended to run on the project's Linux/Bun CI environment.

The production server is started with Bun and exercised through the Astro Node adapter before the home page assertions run.

👀 Want to learn more?

Feel free to check our documentation or jump into our Discord server.