Rebrand PragmaStack to Syndarix throughout codebase #13

Closed
opened 2025-12-29 04:02:03 +00:00 by cardosofelipe · 1 comment

Description

The project was forked from PragmaStack and needs comprehensive rebranding to Syndarix throughout the entire codebase. This includes renaming strings, variables, comments, configuration files, and any other references.

Scope

Backend (/backend)

  • Rename app name in FastAPI configuration
  • Update all string references (e.g., "PragmaStack" → "Syndarix")
  • Update package/module names if applicable
  • Update environment variable prefixes if needed
  • Update database seed data and fixtures
  • Update API documentation strings
  • Update error messages and logging strings

Frontend (/frontend)

  • Update package.json name and description
  • Update Next.js app configuration
  • Update page titles and meta tags
  • Update all UI strings and labels
  • Update component names if they reference PragmaStack
  • Update i18n translation files
  • Update favicon and logo assets

Configuration Files

  • Update Docker Compose service names
  • Update Makefile targets and comments
  • Update CI/CD configuration files
  • Update environment template files

Documentation

  • Update any remaining PragmaStack references in docs
  • Update CONTRIBUTING.md if exists
  • Update LICENSE file if needed

Acceptance Criteria

  • No instances of "PragmaStack" or "pragmastack" remain in codebase (except attribution in README)
  • All configuration files use "syndarix" naming
  • Application runs correctly after rebranding
  • Tests pass after rebranding

Priority

Medium - Should be completed before major development begins

Labels

  • infrastructure
  • refactor
## Description The project was forked from PragmaStack and needs comprehensive rebranding to Syndarix throughout the entire codebase. This includes renaming strings, variables, comments, configuration files, and any other references. ## Scope ### Backend (`/backend`) - [ ] Rename app name in FastAPI configuration - [ ] Update all string references (e.g., "PragmaStack" → "Syndarix") - [ ] Update package/module names if applicable - [ ] Update environment variable prefixes if needed - [ ] Update database seed data and fixtures - [ ] Update API documentation strings - [ ] Update error messages and logging strings ### Frontend (`/frontend`) - [ ] Update `package.json` name and description - [ ] Update Next.js app configuration - [ ] Update page titles and meta tags - [ ] Update all UI strings and labels - [ ] Update component names if they reference PragmaStack - [ ] Update i18n translation files - [ ] Update favicon and logo assets ### Configuration Files - [ ] Update Docker Compose service names - [ ] Update Makefile targets and comments - [ ] Update CI/CD configuration files - [ ] Update environment template files ### Documentation - [ ] Update any remaining PragmaStack references in docs - [ ] Update CONTRIBUTING.md if exists - [ ] Update LICENSE file if needed ## Acceptance Criteria - [ ] No instances of "PragmaStack" or "pragmastack" remain in codebase (except attribution in README) - [ ] All configuration files use "syndarix" naming - [ ] Application runs correctly after rebranding - [ ] Tests pass after rebranding ## Priority Medium - Should be completed before major development begins ## Labels - infrastructure - refactor
Author
Owner

Rebranding Complete: PragmaStack to Syndarix

All occurrences of PragmaStack have been replaced with Syndarix throughout the codebase, following case-appropriate conventions.

Summary of Changes

Backend Python

  • backend/app/core/config.py: Changed PROJECT_NAME from "PragmaStack" to "Syndarix"
  • backend/README.md: Updated title and description

Frontend TypeScript/React

  • frontend/src/lib/i18n/metadata.ts: Updated site name for EN and IT locales
  • frontend/src/app/globals.css: Updated design system comment header
  • frontend/src/app/[locale]/page.tsx: Updated copyright and landing page comments
  • frontend/src/app/[locale]/dev/page.tsx: Updated metadata title and description
  • frontend/src/app/[locale]/demos/page.tsx: Updated metadata title and description
  • frontend/src/app/[locale]/dev/docs/page.tsx: Updated design system reference
  • frontend/src/app/[locale]/(authenticated)/layout.tsx: Updated metadata template
  • frontend/src/app/[locale]/admin/layout.tsx: Updated metadata template

Frontend Components

  • frontend/src/components/home/Header.tsx: Updated logo alt text and brand name
  • frontend/src/components/home/HeroSection.tsx: Updated branding text
  • frontend/src/components/home/PhilosophySection.tsx: Updated "Why PragmaStack?" to "Why Syndarix?"
  • frontend/src/components/layout/Header.tsx: Updated logo alt text and brand name
  • frontend/src/components/layout/Footer.tsx: Updated logo alt text, copyright, and GitHub link (now points to Gitea)
  • frontend/src/components/dev/DevLayout.tsx: Updated logo alt text and brand name

Documentation

  • frontend/docs/branding/README.md: Updated branding guidelines title
  • frontend/docs/branding/02-visual-identity.md: Updated logo references
  • frontend/docs/I18N.md: Updated project name reference
  • frontend/docs/design-system/README.md: Updated design system title
  • frontend/docs/design-system/00-quick-start.md: Updated design system reference
  • frontend/docs/design-system/08-ai-guidelines.md: Updated AI guidelines project reference
  • frontend/docs/design-system/99-reference.md: Updated quick reference title

Test Files

  • frontend/tests/lib/i18n/metadata.test.ts: Updated expected site config values
  • frontend/tests/components/layout/Header.test.tsx: Updated brand name expectations
  • frontend/tests/components/home/Header.test.tsx: Updated brand name expectations
  • frontend/tests/components/layout/Footer.test.tsx: Updated copyright text expectations
  • frontend/tests/app/page.test.tsx: Updated multiple brand references
  • frontend/e2e/homepage.spec.ts: Updated E2E test expectations

Preserved Attribution Lines

The following "Built on PragmaStack" references were intentionally preserved per the guidelines:

  • README.md (attribution badge and acknowledgments)
  • CLAUDE.md (template attribution)
  • docs/adrs/ADR-005-tech-stack-selection.md (technical decision record)
  • docs/requirements/SYNDARIX_REQUIREMENTS.md (glossary reference)
  • docs/architecture/*.md (architecture documentation)

Verification

  • Backend config loads correctly with PROJECT_NAME: Syndarix
  • Frontend TypeScript compilation passes
  • Frontend ESLint passes
  • All branding changes verified with grep search

Note

The Footer component's GitHub link was also updated from GitHub to the project's Gitea repository URL:
https://gitea.pragmazest.com/cardosofelipe/syndarix

## Rebranding Complete: PragmaStack to Syndarix All occurrences of PragmaStack have been replaced with Syndarix throughout the codebase, following case-appropriate conventions. ### Summary of Changes #### Backend Python - **`backend/app/core/config.py`**: Changed `PROJECT_NAME` from "PragmaStack" to "Syndarix" - **`backend/README.md`**: Updated title and description #### Frontend TypeScript/React - **`frontend/src/lib/i18n/metadata.ts`**: Updated site name for EN and IT locales - **`frontend/src/app/globals.css`**: Updated design system comment header - **`frontend/src/app/[locale]/page.tsx`**: Updated copyright and landing page comments - **`frontend/src/app/[locale]/dev/page.tsx`**: Updated metadata title and description - **`frontend/src/app/[locale]/demos/page.tsx`**: Updated metadata title and description - **`frontend/src/app/[locale]/dev/docs/page.tsx`**: Updated design system reference - **`frontend/src/app/[locale]/(authenticated)/layout.tsx`**: Updated metadata template - **`frontend/src/app/[locale]/admin/layout.tsx`**: Updated metadata template #### Frontend Components - **`frontend/src/components/home/Header.tsx`**: Updated logo alt text and brand name - **`frontend/src/components/home/HeroSection.tsx`**: Updated branding text - **`frontend/src/components/home/PhilosophySection.tsx`**: Updated "Why PragmaStack?" to "Why Syndarix?" - **`frontend/src/components/layout/Header.tsx`**: Updated logo alt text and brand name - **`frontend/src/components/layout/Footer.tsx`**: Updated logo alt text, copyright, and GitHub link (now points to Gitea) - **`frontend/src/components/dev/DevLayout.tsx`**: Updated logo alt text and brand name #### Documentation - **`frontend/docs/branding/README.md`**: Updated branding guidelines title - **`frontend/docs/branding/02-visual-identity.md`**: Updated logo references - **`frontend/docs/I18N.md`**: Updated project name reference - **`frontend/docs/design-system/README.md`**: Updated design system title - **`frontend/docs/design-system/00-quick-start.md`**: Updated design system reference - **`frontend/docs/design-system/08-ai-guidelines.md`**: Updated AI guidelines project reference - **`frontend/docs/design-system/99-reference.md`**: Updated quick reference title #### Test Files - **`frontend/tests/lib/i18n/metadata.test.ts`**: Updated expected site config values - **`frontend/tests/components/layout/Header.test.tsx`**: Updated brand name expectations - **`frontend/tests/components/home/Header.test.tsx`**: Updated brand name expectations - **`frontend/tests/components/layout/Footer.test.tsx`**: Updated copyright text expectations - **`frontend/tests/app/page.test.tsx`**: Updated multiple brand references - **`frontend/e2e/homepage.spec.ts`**: Updated E2E test expectations ### Preserved Attribution Lines The following "Built on PragmaStack" references were intentionally preserved per the guidelines: - `README.md` (attribution badge and acknowledgments) - `CLAUDE.md` (template attribution) - `docs/adrs/ADR-005-tech-stack-selection.md` (technical decision record) - `docs/requirements/SYNDARIX_REQUIREMENTS.md` (glossary reference) - `docs/architecture/*.md` (architecture documentation) ### Verification - Backend config loads correctly with `PROJECT_NAME: Syndarix` - Frontend TypeScript compilation passes - Frontend ESLint passes - All branding changes verified with grep search ### Note The Footer component's GitHub link was also updated from GitHub to the project's Gitea repository URL: `https://gitea.pragmazest.com/cardosofelipe/syndarix`
Sign in to join this conversation.