Skip to content

[Advanced]: Update TSC page banner imageΒ #505

Description

@aceppaluni

πŸ§‘β€πŸ”¬ Advanced Issue

Welcome! This is an Advanced Issue touching core website architecture.

It is designed for expert contributors who have demonstrated deep architectural understanding and a proven track record of high-quality contributions.

🐞 Problem Description

Currently our TSC page banner image does not follow our desired design.

With the new vote of the website redesign we would like to update this to reflect the design of our Homepage.

πŸ› οΈ Implementation Notes

Implement the same feature on the homepage into the TSC banner section.

The design should match the figma file speciation outlined here
https://www.figma.com/design/hZztcL7ukzpYLlIklBFzwP/Hiero-Website-Design-Daniel?node-id=1-3&t=3UYJ7D1bhd7NWafv-0

PUSH WORK TO websiteRedesign BRANCH

Markdown Specification:
https://github.com/hiero-ledger/hiero-website/blob/main/docs/design-specs.md

Blog & Content Workflow:

  • Writing Blog Posts β€” covers the current posting flow, front matter format, and content conventions

Project Conventions:

  • Components live in src/components/ β€” follow existing patterns for props, naming, and file structure
  • Pages are under src/app/ using the Next.js App Router
  • Content (blog posts, etc.) lives in content/
  • Styling uses Tailwind CSS

🧠 Advanced Contributors β€” Prerequisites & Expectations

Caution

Advanced issues are the highest-risk work in this project. We will reject PRs that do not meet these standards.

🏁 Concrete Prerequisites

  • Advanced Web Development: Proficient with React, Next.js, and TypeScript.
  • Expertise: Deep architectural understanding of the website's component structure, routing, and build pipeline.
  • Proven History: Successfully completed β‰₯ 10 intermediate issues in this repo.
  • Consistency: β‰₯ 3–4 months of active, human-led contributions to this project.

Note

CI/CD Exception: For issues focused on GitHub Actions / Workflows, the repo-specific thresholds above may be waived if the contributor demonstrates advanced-level proficiency in CI/CD.

⚠️ AI Usage Policy

  • Using AI to generate code for Advanced issues is strictly discouraged
  • AI may be used to help explain file relationships, but cannot be the main source of research.
  • Submitting AI-generated or unvalidated code is grounds for immediate closure

⏱️ Timeline & Workflow

  • Typical time: ~1 month / ~50 hours.
  • πŸ”΄ Completing an advanced issue in 1–3 days is a red flag and will likely be rejected.
  • Suggested: Post your proposed architectural approach as a comment and wait for explicit maintainer approval before writing any code.

πŸ”¬ Technical Domains

  • Advanced React / Next.js (Server Components, App Router, dynamic routing, middleware)
  • Component Architecture (design systems, reusable patterns, composition)
  • Performance & Optimization (Core Web Vitals, image optimization, code splitting, caching)
  • Accessibility (WCAG compliance, screen reader support, keyboard navigation)
  • Build & Deployment (Next.js config, CI/CD, hosting/deployment integration)
  • Testing (unit, integration, E2E, accessibility testing, visual regression)

πŸ›‘οΈ Quality & Review Standards

Advanced PRs must be "safe, maintainable, architecturally sound, and production-ready."

  1. Architectural Fit: The solution must fit naturally into the existing website architecture.
  2. Security & Correctness: Evaluate all logic for injection risks, XSS vulnerabilities, or state corruption issues.
  3. Maintainability: Code must be short and clear enough for any other maintainer to debug without your assistance.
  4. Backward Compatibility: Existing pages, routes, and components must not break. If a breaking change is required, it must be explicitly managed.
  5. Comprehensive Testing: Must include unit and integration tests covering all new logic paths, edge cases, and failure modes. AI-generated tests based on AI-generated code are grounds for immediate rejection.

βœ… PR Quality Checklist

Before opening your PR, the contributor must confirm:

  • I have spent the majority of my time researching the problem and solution space extensively, including reviewing relevant code, documentation, and external resources.
  • I understand the system-wide impact of these changes on affected modules and performance.
  • The design fits with the current website's architectural approaches.
  • I have tested my changes extensively across browsers and screen sizes.
  • Every line of code is personally understood and explainable.

πŸ“š Resources & Support

References:

πŸ†˜ Stuck?

Metadata

Metadata

Assignees

Labels

Projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions