rmjoia · rmjoia · Nov 23, 2025 · Nov 23, 2025
diff --git a/.specify/PROJECT_STATUS.md b/.specify/PROJECT_STATUS.md
@@ -1,8 +1,28 @@
 # CodePals.io Project Status Summary
 
-**Updated**: 2025-11-16  
-**Status**: Ready for Phase 1 Execution  
-**Overall Progress**: Governance, Specification, Planning, and Branding Complete → Task Breakdown In Progress
+**Updated**: 2025-11-23  
+**Status**: Phase 1 Landing Page Complete → Infrastructure Automation In Progress  
+**Overall Progress**: Landing page deployed to production (codepals.io) and development (dev.codepals.io). Infrastructure automation via PowerShell + Bicep in final review (PR #11).
+
+---
+
+## Deployed Environments
+
+### Production
+- **URL**: https://codepals.io ✅ LIVE
+- **Azure Static Web App**: codepals-prod (westeurope)
+- **Subscription**: JewelIT-Prod
+- **Resource Group**: codepals-prod-rg
+- **DNS Zone**: codepals.io (in platform-prod RG)
+- **Status**: Fully deployed with custom domain and HTTPS
+
+### Development
+- **URL**: https://dev.codepals.io ✅ LIVE
+- **Azure Static Web App**: codepals-dev (westeurope)
+- **Subscription**: JewelIT-Dev
+- **Resource Group**: codepals-dev-rg
+- **DNS Zone**: dev.codepals.io (in platform-dev RG, delegated from prod)
+- **Status**: Fully deployed with custom domain and HTTPS
 
 ---
 
@@ -25,24 +45,24 @@
 ---
 
 ### 2. MVP Specification (v1.0) ✅
-- **617 lines** comprehensive feature specification
+- **618 lines** comprehensive feature specification
 - **4 Phases** with independent value delivery:
-  - Phase 1: Foundation & Landing (Weeks 1-2)
+  - Phase 1: Foundation & Landing (Weeks 1-2) ✅ LANDING PAGE COMPLETED
   - Phase 2: Core Platform (Weeks 3-5)
   - Phase 3: Community Engagement (Weeks 6-8)
   - Phase 4: Transparency & Analytics (Weeks 9-10)
 - **39 Functional Requirements** mapped to user stories (FR-1.1 through FR-4.8)
 - **18+ Key Entities** defined (User, CodePals Profile, Connection, Event, HelpBoardPost, Karma, Badge, etc.)
-- **Testing Integration**: Jasmine/Karma unit tests (≥80%), Playwright E2E, WCAG 2.1 AA accessibility
-- **Technology Stack**: Statiq, Azure Static Web Apps, Node.js serverless, Cosmos DB, GitHub OAuth, SendGrid
+- **Testing Integration**: Vitest unit tests (≥80%), Playwright E2E, WCAG 2.1 AA accessibility
+- **Technology Stack**: Astro + TypeScript, Azure Static Web Apps, PowerShell + Bicep (IaC), Node.js serverless (planned), Cosmos DB (planned), GitHub OAuth (planned), SendGrid (planned)
 - **Development Standards**: Security, privacy, performance, i18n requirements embedded in spec
 
-**File**: `.specify/spec/codepals-mvp.md` (617 lines)
+**File**: `.specify/spec/codepals-mvp.md` (618 lines)
 
 ---
 
 ### 3. Implementation Plan (v1.0) ✅
-- **920 lines** detailed 10-week execution roadmap
+- **922 lines** detailed 10-week execution roadmap
 - **~200-250 developer days** estimated effort (1-2 FTE)
 - **Constitution Compliance Check**: All 8 principles embedded with specific quality gates
 - **Architecture & Data Model**: 18 Cosmos DB entities, schema design, i18n structure, encryption strategy
@@ -52,7 +72,7 @@
 - **Resource Requirements**: 1 FTE full-stack dev, 1 QA/tester, 1 designer, 1 DevOps, 1 project owner
 - **Success Metrics**: ≥99.5% uptime, <3sec load time, 50+ users in 30 days, 10+ connections in 45 days
 
-**File**: `.specify/plan/codepals-mvp.md` (921 lines)
+**File**: `.specify/plan/codepals-mvp.md` (922 lines)
 
 ---
 
@@ -100,14 +120,83 @@
 
 ---
 
+### 6. Landing Page Deployment ✅ NEW
+
+**Completed**: November 18, 2025
+
+**Live Sites**:
+- **Production**: https://codepals.io
+- **Development**: https://dev.codepals.io
+
+**Components Deployed**:
+- Hero section with animated background and "Code 'Penpals'" branding
+- Features showcase section
+- How It Works section
+- Call-to-Action with Discord integration (https://discord.gg/nhyzGV7u)
+- Footer with social links and tagline
+- Policy pages: Code of Conduct, Privacy Policy, Terms of Service (pages + modals)
+- Responsive design with mobile-first approach
+- Brand implementation: Teal #00BCD4 + Gold #FFB700 color palette
+
+**Technology**:
+- Astro 5.15+ with TypeScript
+- Tailwind CSS 3.3+
+- Azure Static Web Apps
+- Custom domains with HTTPS enforced
+
+**Build Output**: 4 static pages generated, optimized for performance
+
+---
+
+### 7. Infrastructure Automation ⏳ IN PROGRESS
+
+**Status**: PR #11 in review (being completed by another engineer)
+
+**PowerShell Modules Created**:
+- `Initialize-Infra.ps1` (220 lines): Main orchestration script
+  - Auto-installs required Az modules
+  - Provisions Resource Groups, Managed Identity, Key Vault, Static Web Apps
+  - Stores deployment tokens in Key Vault
+  - Creates federated credentials for GitHub Actions OIDC
+  - Configures custom domains
+- `Initialize-DNS.ps1`: CNAME record management
+- `Initialize-DNSZones.ps1`: DNS zone creation with NS delegation
+
+**Bicep Templates**:
+- `main.bicep`: Infrastructure as Code (IaC) for all Azure resources
+- `dns-delegation.bicep`: Alternative NS delegation method
+
+**Environments**:
+- Dev and Prod fully provisioned
+- Both environments successfully deployed via PowerShell automation
+
+**Remaining Work**:
+- GitHub Actions CI/CD workflow integration
+- Automated testing in pipeline
+- Deployment automation on merge to main
+
+---
+
 ## Current Task Tracking Status
 
-| Phase | Weeks | Status | Effort | Files |
-|-------|-------|--------|--------|-------|
-| Phase 1 | 1-2 | ✅ Ready to Execute | ~50 dev days | phase-1-week-1-tasks.md |
-| Phase 2 | 3-5 | 🟡 Week 3 Detailed | ~75 dev days | phase-2-week-3-detailed-tasks.md |
-| Phase 3 | 6-8 | 🟡 High-level only | ~75 dev days | MVP_COMPLETE_TASK_BREAKDOWN.md |
-| Phase 4 | 9-10 | 🟡 High-level only | ~50 dev days | MVP_COMPLETE_TASK_BREAKDOWN.md |
+| Phase | Weeks | Status | Effort | Completion | Files |
+|-------|-------|--------|--------|------------|-------|
+| Phase 1 | 1-2 | ✅ Landing Page COMPLETE<br>⏳ Infrastructure PR #11 In Review<br>📋 Admin Dashboard Deferred to Phase 2 | ~50 dev days | Week 2: 60% complete<br>(Landing + Infra done, Admin deferred) | phase-1-week-1-tasks.md<br>phase-1-week-2-detailed-tasks.md |
+| Phase 2 | 3-5 | 🟡 Week 3 Detailed<br>📋 Not Started | ~75 dev days | 0% | phase-2-week-3-detailed-tasks.md |
+| Phase 3 | 6-8 | 🟡 High-level only<br>📋 Not Started | ~75 dev days | 0% | MVP_COMPLETE_TASK_BREAKDOWN.md |
+| Phase 4 | 9-10 | 🟡 High-level only<br>📋 Not Started | ~50 dev days | 0% | MVP_COMPLETE_TASK_BREAKDOWN.md |
+
+**Phase 1 Week 2 Deliverables**:
+- ✅ Landing page deployed (codepals.io, dev.codepals.io)
+- ✅ Brand identity implemented (logo, colors, typography)
+- ✅ Policy pages (Code of Conduct, Privacy, Terms)
+- ✅ Responsive design with animations
+- ✅ Infrastructure automation (PowerShell + Bicep)
+- ⏳ CI/CD pipeline (PR #11 in progress)
+- ⏳ Automated deployments (PR #11 in progress)
+- 📋 Admin dashboard (deferred to Phase 2)
+- 📋 Email templates (deferred to Phase 2)
+- 📋 i18n infrastructure (deferred to Phase 2)
 
 ---
 
@@ -166,14 +255,14 @@
 
 ## Team Structure (Recommended)
 
-| Role | FTE | Responsibilities |
-|------|-----|------------------|
-| **Full-Stack Developer** | 1.0 | Backend (Node.js), Frontend (Statiq), API development |
-| **QA / Test Automation** | 1.0 | Unit tests (Jasmine/Karma), E2E tests (Playwright), WCAG testing |
-| **Designer** | 0.5 | Brand implementation, UX/UI reviews, accessibility audit |
-| **DevOps / Infrastructure** | 0.5 | Azure setup, CI/CD pipeline, monitoring, secrets management |
-| **Project Owner** | 0.5 | Requirements, stakeholder communication, decision-making, demos |
-| **Total** | **3.5 FTE** | |
+| Role | FTE | Responsibilities | Current Allocation |
+|------|-----|------------------|-------------------|
+| **Full-Stack Developer** | 1.0 | Backend (Node.js), Frontend (Astro + TypeScript), API development | Active - Landing page complete |
+| **QA / Test Automation** | 1.0 | Unit tests (Vitest), E2E tests (Playwright), WCAG testing | Not yet started |
+| **Designer** | 0.5 | Brand implementation, UX/UI reviews, accessibility audit | Brand identity complete |
+| **DevOps / Infrastructure** | 0.5 | Azure setup, CI/CD pipeline, monitoring, secrets management | Active - PR #11 in review |
+| **Project Owner** | 0.5 | Requirements, stakeholder communication, decision-making, demos | Active |
+| **Total** | **3.5 FTE** | | |
 
 **Effort Distribution**:
 - Week 1-2: Full-stack dev + DevOps + Designer (brand implementation)
@@ -183,37 +272,46 @@
 
 ---
 
-## Next Steps (Ready to Execute)
+## Next Steps (Updated November 23, 2025)
 
 ### Immediate (This Week)
-1. ✅ **Review & Approve** task breakdown and phase structure
-2. ✅ **Assign team members** to Phase 1 tasks
-3. ✅ **Setup project tracking**: GitHub Projects or similar tool
-4. ✅ **Kickoff meeting**: Review governance, spec, plan with team
-
-### Week 1 (Phase 1 Execution)
-1. **Task 1.1.1**: Azure infrastructure setup (DevOps lead)
-2. **Task 1.1.2**: GitHub OAuth configuration (Backend lead)
-3. **Task 1.1.3**: CI/CD pipeline setup (DevOps lead)
-4. **Task 1.1.4**: Backend skeleton (Backend lead)
-
-### Week 2 (Phase 1 Continuation)
-1. **Task 1.2.1**: Brand implementation (Designer + Backend)
-2. **Task 1.2.2**: Landing page (Backend + QA)
-3. **Task 1.2.3**: About page (Backend)
-4. **Task 1.2.4**: Admin dashboard (Backend + QA)
-5. **Task 1.2.5**: Email templates (Backend)
-6. **Task 1.2.6**: i18n setup (Backend)
-
-### Phase 1 Gate Review (Week 2 End)
-- Verify all quality gates passed ✅
-- Demo website to stakeholders
-- Proceed to Phase 2 if gates met
-
-### Weeks 3-5 (Phase 2)
-- Execute detailed tasks from `phase-2-week-3-detailed-tasks.md`
-- Create similar detailed files for Weeks 4-5
-- Continue pattern for Phases 3-4
+1. ✅ **Complete PR #11 Review**: Infrastructure automation (PowerShell + Bicep + GitHub Actions)
+2. 📋 **Merge PR #11**: Enable automated CI/CD pipeline
+3. 📋 **Documentation PR**: Merge documentation updates reflecting actual implementation
+4. 📋 **Workspace Reanalysis**: Verify all work tracked and determine next priorities
+
+### Phase 1 Remaining Items (Deferred from Week 2)
+1. **Admin Dashboard** (deferred to Phase 2 or later)
+   - Profile approval workflow
+   - User management
+   - Content moderation
+2. **Email Templates** (deferred to Phase 2)
+   - Welcome email
+   - Connection request notifications
+3. **i18n Infrastructure** (deferred to Phase 2)
+   - 4 locale support (EN, ES, FR, PT)
+   - Translation workflow
+
+### TypeScript Migration (Planned - Before Phase 2)
+1. **Create tsconfig.json**: Astro-specific TypeScript configuration
+2. **Add type annotations**: Component props, utility functions
+3. **Create type definitions**: API responses, form data, entities
+4. **Install Vitest**: Unit testing framework
+5. **Write initial tests**: Utility functions, components
+
+### Phase 2 Preparation (Weeks 3-5)
+1. **Backend architecture planning**: Node.js serverless, Cosmos DB schema
+2. **GitHub OAuth integration**: Authentication flow design
+3. **User profile system**: Registration, approval, discovery
+4. **Connection system**: Invites, acceptance, privacy controls
+
+### Phase 1 Gate Review (When CI/CD Complete)
+- ✅ Website live (codepals.io, dev.codepals.io) - COMPLETE
+- ⏳ ≥99.5% uptime monitoring - IN PROGRESS
+- ✅ <3sec page load (Lighthouse ≥90) - COMPLETE
+- 📋 Admin dashboard functional - DEFERRED
+- ⏳ Zero security incidents - ONGOING
+- ⏳ Unit test coverage ≥80% - PENDING (Vitest not yet configured)
 
 ---
 
@@ -245,25 +343,30 @@
 
 ## Success Metrics (Post-Launch)
 
-**Week 2 (Phase 1 Complete)**:
-- Website live and publicly accessible
-- ≥99.5% uptime
-- <3sec page load times
-- Zero security incidents
+**Week 2 (Phase 1 Landing Page Complete)** ✅:
+- ✅ Website live and publicly accessible (codepals.io, dev.codepals.io)
+- ⏳ ≥99.5% uptime (monitoring in progress)
+- ✅ <3sec page load times (Lighthouse scores ≥90)
+- ⏳ Zero security incidents (ongoing monitoring)
 
-**Week 5 (Phase 2 Complete)**:
+**Week 2 (Phase 1 Infrastructure Automation)** ⏳:
+- ⏳ CI/CD pipeline operational (PR #11 in review)
+- ⏳ Automated deployments on merge to main
+- ⏳ Unit test coverage ≥80% (Vitest not yet configured)
+
+**Week 5 (Phase 2 Complete)** 📋:
 - 50+ registered users
 - 10+ connections established
 - <5 minute signup-to-profile time
 - <1sec browse response
 
-**Week 8 (Phase 3 Complete)**:
+**Week 8 (Phase 3 Complete)** 📋:
 - ≥80% 7-day user retention
 - 5+ help board posts
 - 10+ Karma points awarded
 - Community events active
 
-**Week 10 (Phase 4 Complete - LAUNCH)**:
+**Week 10 (Phase 4 Complete - LAUNCH)** 📋:
 - Public metrics dashboard live
 - All quality gates passed
 - WCAG 2.1 AA compliance verified
@@ -303,10 +406,14 @@
 
 ## Conclusion
 
-**Status**: All foundational work complete and ready for Phase 1 execution. Governance framework established (Constitution v1.3.0), comprehensive specification written (617 lines, 39 FRs), detailed implementation plan created (920 lines, 10 weeks), brand identity finalized (1 logo concept selected, 5 generated), and detailed task breakdown started (Phase 1-2 detailed, Phase 3-4 high-level).
+**Status**: Phase 1 Week 2 landing page deployment complete ✅. Infrastructure automation in final review (PR #11) ⏳. Admin dashboard, email templates, and i18n deferred to Phase 2.
+
+**Live Sites**:
+- **Production**: https://codepals.io
+- **Development**: https://dev.codepals.io
 
-**Ready to Execute**: Phase 1 Week 1 can begin immediately with team assigned.
+**Next Milestone**: Complete PR #11 (CI/CD automation), then proceed with TypeScript migration and Vitest setup before Phase 2.
 
-**Timeline**: 10 weeks to MVP launch (Weeks 1-10), ~200-250 developer days effort, ~3.5 FTE recommended.
+**Timeline**: Phase 1 landing page complete (November 18, 2025). Infrastructure automation expected completion: November 2025. Phase 2 start: December 2025 (estimated).
 
-**Quality Commitment**: All phases gated by quality gates covering security, testing (≥80% coverage), performance (<3sec), accessibility (WCAG 2.1 AA), i18n (≥95% translation), brand consistency, and governance compliance.
+**Quality Commitment**: All phases gated by quality gates covering security, testing (≥80% coverage with Vitest), performance (<3sec), accessibility (WCAG 2.1 AA), i18n (≥95% translation), brand consistency, and governance compliance.
diff --git a/.specify/plan/codepals-mvp.md b/.specify/plan/codepals-mvp.md
@@ -26,7 +26,7 @@ This implementation plan translates the CodePals.io MVP specification (617 lines
 All 8 principles from Constitution v1.3.0 are embedded in this plan:
 
 ✅ **Principle 1: Open Source & Transparency** - Public repo, no secrets in code, governance transparent  
-✅ **Principle 2: Code Quality** - Jasmine/Karma unit tests (≥80%), Playwright E2E, peer review mandatory  
+✅ **Principle 2: Code Quality** - Vitest unit tests (≥80%), Playwright E2E, peer review mandatory  
 ✅ **Principle 3: Security** - OWASP best practices, input validation, env-var secrets, HTTPS enforced  
 ✅ **Principle 4: Performance** - <3sec landing page load, API latency <1sec, monitoring active  
 ✅ **Principle 5: Privacy** - Minimal data collection, location visibility toggle, encrypted sensitive fields  
@@ -54,15 +54,16 @@ All 8 principles from Constitution v1.3.0 are embedded in this plan:
 
 | Layer | Choice | Rationale | MVP Fit |
 |-------|--------|-----------|---------|
-| **Frontend** | Statiq | Static site gen, simple, fast, no client-side complexity | ✅ Landing + admin UI + events |
+| **Frontend** | Astro + TypeScript | Modern static site gen, component-based, TypeScript support, excellent DX | ✅ Landing + admin UI + events |
 | **Hosting** | Azure Static Web Apps | Free tier, scales, built-in CI/CD, HTTPS | ✅ Phase 1 launch target |
+| **Infrastructure** | PowerShell + Bicep | Automated provisioning, Infrastructure as Code, GitHub Actions orchestration | ✅ Dev + Prod environments |
 | **Backend** | Node.js Serverless | Fast startup, Azure Functions integration, cost-effective | ✅ API endpoints, workflows |
 | **Database** | Cosmos DB (free tier) | NoSQL, 400 RU/s sufficient for MVP, scales easily | ✅ Document-oriented schema |
 | **Auth** | GitHub OAuth | Free, familiar to dev audience, zero passwords to manage | ✅ Profile creation flow |
 | **Email** | SendGrid | 100 emails/day free tier, reliable, templates | ✅ Notifications, approvals |
 | **Monitoring** | Azure App Insights | Free tier, error logging, performance monitoring | ✅ SLA tracking, troubleshooting |
-| **CI/CD** | GitHub Actions | Native to repo, free, reliable | ✅ Automated testing + deploy |
-| **Testing (Unit)** | Jasmine/Karma | User's known stack, familiar, mature | ✅ Per Constitution Principle 2 |
+| **CI/CD** | GitHub Actions + PowerShell | GitHub Actions orchestrates PowerShell modules for infrastructure | ✅ Automated testing + deploy |
+| **Testing (Unit)** | Vitest | Modern, fast, TypeScript-first testing framework | ✅ Per Constitution Principle 2 |
 | **Testing (E2E)** | Playwright | Cross-browser, fast, maintainable | ✅ Critical user journey validation |
 
 ### Data Model Overview

diff --git a/.specify/spec/codepals-mvp.md b/.specify/spec/codepals-mvp.md
@@ -57,11 +57,12 @@
 
 ### Testing Strategy
 
-**Unit Testing (Jasmine/Karma)**:
+**Unit Testing (Vitest)**:
 - All new business logic MUST have unit test coverage
 - Meaningful assertions for normal and edge cases
 - Negative test cases for error paths
 - Target: ≥80% code coverage for core modules
+- TypeScript-first testing framework with excellent DX
 
 **Integration Testing**:
 - API endpoints tested with realistic data flows
@@ -82,10 +83,11 @@
 
 ### Technology Stack
 
-**Frontend & Static Site**: Statiq, Azure Static Web Apps  
+**Frontend & Static Site**: Astro + TypeScript, Azure Static Web Apps  
+**Infrastructure**: PowerShell + Bicep (Infrastructure as Code)  
 **Backend**: Node.js serverless, Cosmos DB  
-**Testing**: Jest/Vitest (unit), Playwright (E2E)  
-**CI/CD**: GitHub Actions  
+**Testing**: Vitest (unit), Playwright (E2E)  
+**CI/CD**: GitHub Actions + PowerShell modules  
 **Monitoring**: Azure Application Insights  
 **Email**: SendGrid API  
 **Auth**: GitHub OAuth
@@ -108,7 +110,7 @@
 
 **Acceptance Scenarios**:
 
-1. **Given** deployment pipeline configured, **When** code is committed to main, **Then** static site builds via Statiq and deploys to Azure Static Web Apps.
+1. **Given** deployment pipeline configured, **When** code is committed to main, **Then** static site builds via Astro and deploys to Azure Static Web Apps.
 2. **Given** backend API configured, **When** Node.js serverless function deployed, **Then** API endpoints respond (health check: `/api/health` returns 200 OK).
 3. **Given** Cosmos DB free tier provisioned, **When** connection string configured, **Then** database queries execute successfully.
 4. **Given** GitHub OAuth app created, **When** authentication flow tested, **Then** OAuth returns valid user ID and username.