GitHunt
PO

ponderingdemocritus/build-australia

Branch mirror for Build-Australia PRs

Build Australia

A pre-launch website tracking key performance indicators for Australia's progress across energy, housing, productivity, and innovation.

๐ŸŒ Live Site: https://build-australia.pages.dev/ (custom domain coming later)

Overview

Build Australia provides data-driven insights on the metrics that matter most for Australia's future. Currently in pre-launch mode with coming soon indicators for all KPIs.

Features

  • 9 Key Metrics: Tracking energy costs, renewable energy, housing affordability, productivity, GDP per capita, R&D investment, business confidence, infrastructure workforce, and current account balance
  • Clean Design: Inspired by buildcanada.com with responsive grid layout
  • Newsletter Signup: Monthly updates and analysis
  • Pre-launch Ready: All metrics show "Coming Soon" status

Tech Stack

Client (Frontend)

  • Astro 5.0 - Modern static site generator with partial hydration
  • React 19 + TypeScript - UI components with latest React features
  • Tailwind CSS 4.0 - Utility-first CSS framework with Vite plugin
  • shadcn/ui - Accessible component library built on Radix UI
  • Recharts - Data visualization for metric charts
  • TanStack React Table - Powerful table components

Server (Backend)

  • Bun runtime for data scraping and processing

Development

Client Setup

# Navigate to client directory
cd client

# Install dependencies
npm install

# Start development server (runs on port 3000)
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

# Deploy to Cloudflare Pages
npm run deploy

Server Setup

# Navigate to server directory
cd server

# Install dependencies (if any)
bun install

# Run the scraper
bun run index.ts

Project Structure

build-australia/
โ”œโ”€โ”€ client/                    # Frontend Astro application
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”œโ”€โ”€ components/       # Reusable components
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ Header.astro  # Site header
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ Footer.astro  # Site footer
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ MetricCard.tsx # KPI display cards
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ react/       # Interactive React components
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ ui/          # shadcn/ui components
โ”‚   โ”‚   โ”œโ”€โ”€ pages/           # Astro file-based routing
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ index.astro  # Main dashboard
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ about.astro  # About page
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ manifesto.astro # Manifesto page
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ projects/    # Projects section
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ essays/      # Essays section
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ newsletter.astro # Newsletter signup
โ”‚   โ”‚   โ”œโ”€โ”€ data/            # Data definitions
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ metrics.ts   # KPI definitions
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ australian-inventions.ts
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ projects-registry.ts
โ”‚   โ”‚   โ””โ”€โ”€ styles/          # Global styles with Tailwind
โ”‚   โ”œโ”€โ”€ astro.config.mjs     # Astro configuration
โ”‚   โ””โ”€โ”€ package.json
โ””โ”€โ”€ server/                   # Backend Bun application
    โ””โ”€โ”€ readme.md            # Server documentation

Metrics Tracked

  1. Residential Electricity Prices (c/kWh)
  2. Renewable Energy Share (%)
  3. Housing Affordability Ratio (ratio)
  4. Labour Productivity Growth (% quarterly)
  5. GDP per Capita (USD)
  6. R&D Investment Intensity (% of GDP)
  7. Business Confidence (index points)
  8. Infrastructure Worker Shortage (thousand workers)
  9. Current Account Balance (% of GDP)

Launch Preparation

All metrics currently show "Coming Soon" status. To go live:

  1. Update client/src/data/metrics.ts with real data
  2. Configure the server scraper to fetch live data
  3. Add actual source URLs
  4. Update trend indicators
  5. Consider adding historical context and expert quotes

Deployment

The site is deployed via Cloudflare Pages with automatic deployments from the main branch:

  • Live URL: https://build-australia.pages.dev/
  • Auto-deploy: Pushes to main trigger automatic builds
  • Build command: cd client && npm install && npm run build
  • Output directory: client/dist
  • Framework preset: Astro
  • Node version: 18+ recommended
  • Custom domain: Coming soon

To deploy manually from the client directory:

npm run deploy

Contributing

This is a pre-launch project. Contributions welcome once live data integration begins.

License

MIT