· 2 min read
Customize MyPayCheckCal for your organization
Learn how to adapt the MyPayCheckCal experience—branding, calculators, and disclosures—to match your company’s payroll policies.
Every payroll team has unique needs. Some employers need disclaimers for multiple states, while others want calculators branded for onboarding portals. MyPayCheckCal is designed to adapt quickly. Follow the steps below to tailor the experience without fighting the framework.
Update brand elements
- Colors and typography: Edit
tailwind.config.jsto update thetheme.extend.colorsand typography settings. Because most UI pieces rely on CSS variables, changing the palette automatically flows to buttons, cards, and charts. - Logos and icons: Replace the assets inside
public/and update imports insrc/components/widgets/Header.astroandFooter.astro. - Meta tags: Adjust descriptions, titles, and social metadata in
src/config.yaml. The virtual module keeps the values synchronized across the sitemap, RSS feed, and blog pages.
Configure calculators
- Default values: Each calculator island exports a
defaultState. Customize wage amounts, filing statuses, or deduction assumptions to match your organization. - Input labels: Update the localized strings inside the calculator component to reflect your terminology (for example, “benefit credits” instead of “stipend”).
- Additional adjustments: Extend the reducers in the islands to add new deduction buckets or employer contributions. Shared helper functions like
calculateTaxWithholdingensure your logic stays consistent.
Add jurisdiction-specific guidance
- Create a markdown file under
src/guidesfor each state or policy you want to highlight. - Link the new guides from
src/navigation.tsso visitors can access them from the header and footer. - Use the
Alertcomponent to surface critical compliance notes directly within calculator result cards.
Keep disclosures current
Compliance statements and disclaimers live in src/components/calculators/PaycheckResults.tsx. Update the copy to include payout timing, responsible parties, or contact information for payroll questions.
With these adjustments, MyPayCheckCal becomes a tailored payroll companion—delivering accurate numbers while reflecting the voice and policies of your organization.