The-Phoenix-Hwb

The Phoenix Post - Home, Work & Business

«««< HEAD Main build

---

Migration Notice (2025-06-20):

• The codebase is now fully migrated to TypeScript (.tsx) and Tailwind CSS.
• All legacy .jsx, .stories.jsx, and .test.jsx files have been archived in archived-jsx.zip at the project root.
• All new development must use .tsx and follow the new architecture and linting rules.

See POST_MIGRATION_TASK_LOG.md for remaining post-migration tasks.

The Phoenix Post is a comprehensive full-stack web application serving the Home, Work & Business community.

Project Structure

This repository contains:

• Frontend: thephoenixpost-vite/ - React/Vite application
• Backend: phoenixpost-cms/ - Strapi CMS
• Documentation: Various guides and checklists for development and deployment

Quick Start

Prerequisites

• Node.js 18+
• npm 6+

Installation

1. Clone the repository
2. Install root dependencies: npm install
3. Install frontend dependencies: cd thephoenixpost-vite && npm install
4. Install backend dependencies: cd phoenixpost-cms && npm install

Development

1. Start the backend: cd phoenixpost-cms && npm run develop
2. Start the frontend: cd thephoenixpost-vite && npm run dev

Building

• Frontend build: cd thephoenixpost-vite && npm run build
• Backend build: cd phoenixpost-cms && npm run build

Testing

• Run frontend tests: cd thephoenixpost-vite && npm test
• Run E2E tests: cd thephoenixpost-vite && npm run cypress // [Phoenix Refactor 2025] Storybook reference removed for production

Documentation

See the docs/ directory and individual project folders for detailed documentation.

Contributing

See CONTRIBUTING.md for contribution guidelines.

CI & Automation

The frontend (thephoenixpost-vite/) includes scripted automation to standardize quality checks:

• npm run ci:lint – ESLint + Stylelint (CSS enhancement layer gated with @supports)
• npm run ci:test – Vitest unit/integration suite
• npm run ci:e2e – Playwright end-to-end (progressive enhancement & critical flows)
• npm run design-tokens – Extracts CSS custom properties -> design-tokens.json
• npm run ci:all – Runs the full pipeline (lint → test → e2e → tokens)

Integrate in a workflow (example):

jobs:
	build:
		runs-on: ubuntu-latest
		steps:
			- uses: actions/checkout@v4
			- uses: actions/setup-node@v4
				with:
					node-version: 20
					cache: npm
			- run: npm ci
			- run: cd thephoenixpost-vite && npm ci
			- run: cd thephoenixpost-vite && npm run ci:all

design-tokens.json can be published as a build artifact or consumed by the CMS for synchronized theming. // [Phoenix Refactor 2025]

560254ff8539e9acf431722b6b14d75d81e5e1cf