Oursky web (Astro)

Static marketing site for Oursky, rebuilt from Webflow as an Astro 6 project with Tailwind CSS 4, MDX content collections, and a checked-in Webflow export under ref/ for parity reference.

Requirements

• Node.js 22.12 or newer (see package.json engines and .nvmrc)

Local development

npm install
npm run dev

The dev server defaults to http://localhost:4321.

npm run build    # production build → dist/
npm run preview  # serve dist/ locally

Environment variables

Copy .env.example to .env when you need Webflow migration scripts or future analytics keys. The static site build does not require a .env file.

GitHub

Create a new empty repository, then from this directory:

git remote add origin https://github.com/<org>/<repo>.git
git branch -M main
git push -u origin main

Netlify

1. In the Netlify dashboard, connect the GitHub repository. Build command and publish directory come from netlify.toml.
2. Deploy previews use DEPLOY_PRIME_URL for canonical URLs, Open Graph base URLs, and the sitemap. Production deploys (CONTEXT=production) use https://www.oursky.com unless you set PUBLIC_SITE_URL under Site → Settings → Environment variables.
3. Contact form submissions land in Site → Forms → oursky-contact. Configure email notifications under Forms → Settings → Form notifications.
4. Redirect rules live in netlify.toml. Regenerate the imported set with npm run convert:redirects exports/webflow/redirects.csv after refreshing the CSV.
5. Optional: enable Password protection on preview deploys if the site should not be publicly reachable before launch.

Content tooling

Script	Purpose
npm run generate:works	Regenerate work stubs
npm run generate:blog-stubs	Blog stub generator
npm run generate:blog-stubs:all	Same with --force

Docs

Migration notes and phase handoffs live in docs/.