@jsonresume/core 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +689 -0
- package/dist/resume-print.css +425 -0
- package/dist/tokens.css +139 -0
- package/package.json +66 -0
- package/src/badges/BadgeRowOutline.jsx +118 -0
- package/src/badges/BadgeRowOutline.stories.tsx +160 -0
- package/src/badges/index.jsx +5 -0
- package/src/callouts/Callout.jsx +80 -0
- package/src/callouts/Callout.stories.tsx +27 -0
- package/src/callouts/HighlightCard.jsx +114 -0
- package/src/callouts/HighlightCard.stories.tsx +27 -0
- package/src/callouts/InfoBox.jsx +82 -0
- package/src/callouts/InfoBox.stories.tsx +26 -0
- package/src/callouts/index.jsx +4 -0
- package/src/certifications/AwardCard.jsx +83 -0
- package/src/certifications/AwardCard.stories.tsx +32 -0
- package/src/certifications/CertificationBadge.jsx +85 -0
- package/src/certifications/CertificationBadge.stories.tsx +29 -0
- package/src/certifications/CertificationRow.jsx +150 -0
- package/src/certifications/CertificationRow.stories.tsx +64 -0
- package/src/certifications/HonorsList.jsx +87 -0
- package/src/certifications/HonorsList.stories.tsx +36 -0
- package/src/certifications/index.jsx +5 -0
- package/src/containers/AccentCalloutPanel.jsx +176 -0
- package/src/containers/AccentCalloutPanel.stories.tsx +105 -0
- package/src/containers/MutedPanel.jsx +125 -0
- package/src/containers/MutedPanel.stories.tsx +113 -0
- package/src/containers/RoleBlockFramed.jsx +191 -0
- package/src/containers/RoleBlockFramed.stories.tsx +230 -0
- package/src/containers/SoftCardOutline.jsx +161 -0
- package/src/containers/SoftCardOutline.stories.tsx +174 -0
- package/src/containers/index.jsx +9 -0
- package/src/data/KPIChipLine.jsx +158 -0
- package/src/data/KPIChipLine.stories.tsx +99 -0
- package/src/data/KeyValueInline.jsx +150 -0
- package/src/data/KeyValueInline.stories.tsx +136 -0
- package/src/data/MetricBar.jsx +93 -0
- package/src/data/MetricBar.stories.tsx +31 -0
- package/src/data/MetricBullet.jsx +129 -0
- package/src/data/MetricBullet.stories.tsx +99 -0
- package/src/data/MetricInline.jsx +60 -0
- package/src/data/MetricInline.stories.tsx +53 -0
- package/src/data/ProgressCircle.jsx +81 -0
- package/src/data/ProgressCircle.stories.tsx +102 -0
- package/src/data/StatCard.jsx +65 -0
- package/src/data/StatCard.stories.tsx +29 -0
- package/src/data/index.jsx +12 -0
- package/src/dates/DateBadge.jsx +73 -0
- package/src/dates/DateBadge.stories.tsx +30 -0
- package/src/dates/RelativeDate.jsx +121 -0
- package/src/dates/RelativeDate.stories.tsx +29 -0
- package/src/dates/index.jsx +3 -0
- package/src/experience/ExperienceCard.jsx +82 -0
- package/src/experience/ExperienceCard.stories.tsx +36 -0
- package/src/experience/ExperienceCompact.jsx +72 -0
- package/src/experience/ExperienceCompact.stories.tsx +53 -0
- package/src/experience/ExperienceGrid.jsx +65 -0
- package/src/experience/ExperienceGrid.stories.tsx +63 -0
- package/src/experience/ExperienceTimeline.jsx +24 -0
- package/src/experience/ExperienceTimeline.stories.tsx +63 -0
- package/src/experience/RoleHeaderCompact.jsx +99 -0
- package/src/experience/index.jsx +9 -0
- package/src/header/ContactRowLine.jsx +125 -0
- package/src/header/ContactRowLine.stories.tsx +65 -0
- package/src/header/CornerInitials.jsx +178 -0
- package/src/header/CornerInitials.stories.tsx +129 -0
- package/src/header/Footer.jsx +50 -0
- package/src/header/Footer.stories.tsx +25 -0
- package/src/header/HeaderCentered.jsx +51 -0
- package/src/header/HeaderCentered.stories.tsx +30 -0
- package/src/header/HeaderMinimal.jsx +50 -0
- package/src/header/HeaderMinimal.stories.tsx +29 -0
- package/src/header/HeaderSplit.jsx +65 -0
- package/src/header/HeaderSplit.stories.tsx +29 -0
- package/src/header/HeroNameBlock.jsx +71 -0
- package/src/header/HeroNameBlock.stories.tsx +37 -0
- package/src/header/NameStackElegant.jsx +104 -0
- package/src/header/NameStackElegant.stories.tsx +60 -0
- package/src/header/PageBreak.jsx +25 -0
- package/src/header/PageBreak.stories.tsx +22 -0
- package/src/header/SectionFlagTitle.jsx +87 -0
- package/src/header/SectionFlagTitle.stories.tsx +53 -0
- package/src/header/SectionRuleTitle.jsx +84 -0
- package/src/header/SectionRuleTitle.stories.tsx +52 -0
- package/src/header/index.jsx +18 -0
- package/src/helpers/calculations.js +428 -0
- package/src/index.js +253 -0
- package/src/languages/LanguageBar.jsx +90 -0
- package/src/languages/LanguageBar.stories.tsx +28 -0
- package/src/languages/LanguageGrid.jsx +118 -0
- package/src/languages/LanguageGrid.stories.tsx +33 -0
- package/src/languages/LanguageLevelBarLite.jsx +147 -0
- package/src/languages/LanguageLevelBarLite.stories.tsx +74 -0
- package/src/languages/ProficiencyScale.jsx +107 -0
- package/src/languages/ProficiencyScale.stories.tsx +30 -0
- package/src/languages/index.jsx +5 -0
- package/src/layouts/CardLayout.jsx +46 -0
- package/src/layouts/CardLayout.stories.tsx +272 -0
- package/src/layouts/FlexLayout.jsx +53 -0
- package/src/layouts/FlexLayout.stories.tsx +270 -0
- package/src/layouts/GridLayout.jsx +38 -0
- package/src/layouts/GridLayout.stories.tsx +183 -0
- package/src/layouts/SidebarLayout.jsx +63 -0
- package/src/layouts/SidebarLayout.stories.tsx +162 -0
- package/src/layouts/StackLayout.jsx +26 -0
- package/src/layouts/StackLayout.stories.tsx +192 -0
- package/src/layouts/TwoColumnMicroGrid.jsx +87 -0
- package/src/layouts/TwoColumnMicroGrid.stories.tsx +96 -0
- package/src/layouts/index.jsx +11 -0
- package/src/lists/AchievementListSpacious.jsx +81 -0
- package/src/lists/AchievementListSpacious.stories.tsx +49 -0
- package/src/lists/AchievementListTight.jsx +80 -0
- package/src/lists/AchievementListTight.stories.tsx +49 -0
- package/src/lists/BulletList.jsx +66 -0
- package/src/lists/BulletList.stories.tsx +38 -0
- package/src/lists/CheckList.jsx +94 -0
- package/src/lists/CheckList.stories.tsx +38 -0
- package/src/lists/CompactList.jsx +90 -0
- package/src/lists/CompactList.stories.tsx +34 -0
- package/src/lists/DefinitionKeyline.jsx +114 -0
- package/src/lists/DefinitionKeyline.stories.tsx +90 -0
- package/src/lists/HangingBulletList.jsx +82 -0
- package/src/lists/HangingBulletList.stories.tsx +50 -0
- package/src/lists/IconList.jsx +89 -0
- package/src/lists/IconList.stories.tsx +36 -0
- package/src/lists/ListDashCompact.jsx +69 -0
- package/src/lists/ListDashCompact.stories.tsx +60 -0
- package/src/lists/MiniDotLeaderList.jsx +69 -0
- package/src/lists/MiniDotLeaderList.stories.tsx +73 -0
- package/src/lists/NumberedList.jsx +74 -0
- package/src/lists/NumberedList.stories.tsx +39 -0
- package/src/lists/index.jsx +12 -0
- package/src/metadata/GreyLabelCaps.jsx +66 -0
- package/src/metadata/GreyLabelCaps.stories.tsx +40 -0
- package/src/metadata/InlineKicker.jsx +61 -0
- package/src/metadata/InlineKicker.stories.tsx +35 -0
- package/src/metadata/MetaRow.jsx +96 -0
- package/src/metadata/MetaRow.stories.tsx +38 -0
- package/src/metadata/SmallCapsHeading.jsx +75 -0
- package/src/metadata/SmallCapsHeading.stories.tsx +54 -0
- package/src/metadata/SubsectionLabel.jsx +92 -0
- package/src/metadata/SubsectionLabel.stories.tsx +40 -0
- package/src/metadata/index.jsx +10 -0
- package/src/primitives/AccentSidebarStripe.stories.tsx +65 -0
- package/src/primitives/AccentSidebarStripe.tsx +95 -0
- package/src/primitives/AccentTopRule.stories.tsx +102 -0
- package/src/primitives/AccentTopRule.tsx +103 -0
- package/src/primitives/Badge.jsx +125 -0
- package/src/primitives/Badge.stories.tsx +27 -0
- package/src/primitives/ContactInfo.jsx +133 -0
- package/src/primitives/ContactInfo.stories.tsx +30 -0
- package/src/primitives/DIVIDERS.md +333 -0
- package/src/primitives/DateRange.jsx +178 -0
- package/src/primitives/DateRange.stories.tsx +28 -0
- package/src/primitives/DottedDivider.stories.tsx +54 -0
- package/src/primitives/DottedDivider.tsx +102 -0
- package/src/primitives/InlineSeparatorPipe.jsx +64 -0
- package/src/primitives/InlineSeparatorPipe.stories.tsx +96 -0
- package/src/primitives/KeylineDivider.stories.tsx +48 -0
- package/src/primitives/KeylineDivider.tsx +80 -0
- package/src/primitives/Link.jsx +59 -0
- package/src/primitives/Link.stories.tsx +29 -0
- package/src/primitives/ListItem.jsx +127 -0
- package/src/primitives/ListItem.stories.tsx +27 -0
- package/src/primitives/RulesetStack.stories.tsx +85 -0
- package/src/primitives/RulesetStack.tsx +117 -0
- package/src/primitives/Section.jsx +37 -0
- package/src/primitives/Section.stories.tsx +28 -0
- package/src/primitives/SectionTitle.jsx +62 -0
- package/src/primitives/SectionTitle.stories.tsx +27 -0
- package/src/primitives/index.jsx +36 -0
- package/src/print/ColumnBreak.jsx +44 -0
- package/src/print/ColumnBreak.stories.tsx +22 -0
- package/src/print/KeepTogether.jsx +24 -0
- package/src/print/KeepTogether.stories.tsx +26 -0
- package/src/print/LetterheadBar.jsx +100 -0
- package/src/print/LetterheadBar.stories.tsx +141 -0
- package/src/print/PageFooterLine.jsx +93 -0
- package/src/print/PageFooterLine.stories.tsx +121 -0
- package/src/print/PageHeaderLine.jsx +59 -0
- package/src/print/PageHeaderLine.stories.tsx +108 -0
- package/src/print/PrintOnly.jsx +49 -0
- package/src/print/PrintOnly.stories.tsx +26 -0
- package/src/print/SoftShadowEmulation.jsx +88 -0
- package/src/print/SoftShadowEmulation.stories.tsx +214 -0
- package/src/print/index.jsx +8 -0
- package/src/profile/Avatar.jsx +66 -0
- package/src/profile/Avatar.stories.tsx +84 -0
- package/src/profile/ContactGrid.jsx +63 -0
- package/src/profile/ContactGrid.stories.tsx +33 -0
- package/src/profile/ProfileCard.jsx +73 -0
- package/src/profile/ProfileCard.stories.tsx +35 -0
- package/src/profile/SocialLinks.jsx +61 -0
- package/src/profile/SocialLinks.stories.tsx +33 -0
- package/src/profile/index.jsx +9 -0
- package/src/providers/ThemeProvider.jsx +56 -0
- package/src/providers/ThemeProvider.stories.tsx +149 -0
- package/src/publications/PortfolioGrid.jsx +122 -0
- package/src/publications/PortfolioGrid.stories.tsx +62 -0
- package/src/publications/ProjectCard.jsx +151 -0
- package/src/publications/ProjectCard.stories.tsx +36 -0
- package/src/publications/PublicationEntryPlain.jsx +127 -0
- package/src/publications/PublicationEntryPlain.stories.tsx +58 -0
- package/src/publications/PublicationItem.jsx +120 -0
- package/src/publications/PublicationItem.stories.tsx +32 -0
- package/src/publications/index.jsx +5 -0
- package/src/quotes/BlockQuote.jsx +55 -0
- package/src/quotes/BlockQuote.stories.tsx +33 -0
- package/src/quotes/PullQuote.jsx +70 -0
- package/src/quotes/PullQuote.stories.tsx +32 -0
- package/src/quotes/Testimonial.jsx +99 -0
- package/src/quotes/Testimonial.stories.tsx +36 -0
- package/src/quotes/index.jsx +4 -0
- package/src/skills/SkillBar.jsx +66 -0
- package/src/skills/SkillBar.stories.tsx +112 -0
- package/src/skills/SkillCategory.jsx +71 -0
- package/src/skills/SkillCategory.stories.tsx +197 -0
- package/src/skills/SkillCloud.jsx +53 -0
- package/src/skills/SkillCloud.stories.tsx +132 -0
- package/src/skills/SkillGroup.jsx +56 -0
- package/src/skills/SkillGroup.stories.tsx +162 -0
- package/src/skills/SkillPill.jsx +56 -0
- package/src/skills/SkillPill.stories.tsx +157 -0
- package/src/skills/SkillRating.jsx +60 -0
- package/src/skills/SkillRating.stories.tsx +115 -0
- package/src/skills/index.jsx +11 -0
- package/src/styles/tokens.css +139 -0
- package/src/tables/ComparisonTable.jsx +128 -0
- package/src/tables/ComparisonTable.stories.tsx +41 -0
- package/src/tables/DataTable.jsx +149 -0
- package/src/tables/DataTable.stories.tsx +64 -0
- package/src/tables/SkillMatrix.jsx +139 -0
- package/src/tables/SkillMatrix.stories.tsx +90 -0
- package/src/tables/index.jsx +4 -0
- package/src/tags/ToolTagRibbon.jsx +106 -0
- package/src/tags/ToolTagRibbon.stories.tsx +121 -0
- package/src/tags/index.jsx +5 -0
- package/src/timeline/TimelineInline.stories.tsx +83 -0
- package/src/timeline/TimelineInline.tsx +202 -0
- package/src/timeline/TimelineItem.jsx +106 -0
- package/src/timeline/TimelineItem.stories.tsx +64 -0
- package/src/timeline/TimelineRuleMinimal.stories.tsx +68 -0
- package/src/timeline/TimelineRuleMinimal.tsx +165 -0
- package/src/timeline/TimelineSection.jsx +21 -0
- package/src/timeline/TimelineSection.stories.tsx +44 -0
- package/src/timeline/index.jsx +9 -0
- package/src/tokens/index.js +164 -0
- package/src/typography/Heading.jsx +48 -0
- package/src/typography/Heading.stories.tsx +46 -0
- package/src/typography/HyphenationSafeParagraph.jsx +98 -0
- package/src/typography/HyphenationSafeParagraph.stories.tsx +151 -0
- package/src/typography/Label.jsx +38 -0
- package/src/typography/Label.stories.tsx +27 -0
- package/src/typography/QuoteStripe.jsx +78 -0
- package/src/typography/QuoteStripe.stories.tsx +63 -0
- package/src/typography/SectionIntroParagraph.jsx +62 -0
- package/src/typography/SectionIntroParagraph.stories.tsx +57 -0
- package/src/typography/Text.jsx +42 -0
- package/src/typography/Text.stories.tsx +35 -0
- package/src/typography/index.jsx +11 -0
- package/src/utils/Divider.jsx +32 -0
- package/src/utils/Divider.stories.tsx +24 -0
- package/src/utils/Flex.jsx +6 -0
- package/src/utils/Flex.stories.tsx +28 -0
- package/src/utils/Grid.jsx +6 -0
- package/src/utils/Grid.stories.tsx +28 -0
- package/src/utils/Spacer.jsx +18 -0
- package/src/utils/Spacer.stories.tsx +26 -0
- package/src/utils/index.jsx +9 -0
- package/src/utils/security.js +155 -0
- package/src/visuals/BackgroundPattern.jsx +65 -0
- package/src/visuals/BackgroundPattern.stories.tsx +27 -0
- package/src/visuals/BorderAccent.jsx +147 -0
- package/src/visuals/BorderAccent.stories.tsx +27 -0
- package/src/visuals/ColorBlock.jsx +60 -0
- package/src/visuals/ColorBlock.stories.tsx +27 -0
- package/src/visuals/DividerVariants.jsx +120 -0
- package/src/visuals/DividerVariants.stories.tsx +27 -0
- package/src/visuals/index.jsx +5 -0
package/README.md
ADDED
|
@@ -0,0 +1,689 @@
|
|
|
1
|
+
# @jsonresume/core
|
|
2
|
+
|
|
3
|
+
**React component library for building ATS-friendly, print-optimized resume themes**
|
|
4
|
+
|
|
5
|
+
A comprehensive collection of 200+ React components, design tokens, and utilities that enable rapid development of professional resume themes. Built with styled-components for maximum flexibility and SSR support.
|
|
6
|
+
|
|
7
|
+
## Features
|
|
8
|
+
|
|
9
|
+
- **200+ React Components** - Comprehensive primitives across 20 categories
|
|
10
|
+
- **Design Tokens System** - Typography, colors, spacing, layout, radius, shadows
|
|
11
|
+
- **Security Utilities** - URL validation, HTML sanitization, external link detection
|
|
12
|
+
- **Calculation Helpers** - 20+ functions for resume metrics and statistics
|
|
13
|
+
- **SSR Support** - Full server-side rendering with styled-components
|
|
14
|
+
- **Print Optimization** - Perfect PDF exports with @media print styles
|
|
15
|
+
- **ATS-Friendly** - Semantic HTML, proper heading hierarchy, accessibility features
|
|
16
|
+
- **Theme Support** - ThemeProvider with customizable design tokens
|
|
17
|
+
|
|
18
|
+
## Installation
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
npm install @jsonresume/core
|
|
22
|
+
# or
|
|
23
|
+
yarn add @jsonresume/core
|
|
24
|
+
# or
|
|
25
|
+
pnpm add @jsonresume/core
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
**Peer Dependencies:**
|
|
29
|
+
|
|
30
|
+
This package requires React 18 or 19 and styled-components:
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
npm install react react-dom styled-components
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## Quick Start
|
|
37
|
+
|
|
38
|
+
```jsx
|
|
39
|
+
import React from 'react';
|
|
40
|
+
import {
|
|
41
|
+
ThemeProvider,
|
|
42
|
+
Section,
|
|
43
|
+
SectionTitle,
|
|
44
|
+
ListItem,
|
|
45
|
+
DateRange,
|
|
46
|
+
Badge,
|
|
47
|
+
BadgeList,
|
|
48
|
+
} from '@jsonresume/core';
|
|
49
|
+
|
|
50
|
+
function Resume({ resume }) {
|
|
51
|
+
return (
|
|
52
|
+
<ThemeProvider>
|
|
53
|
+
<Section id="work">
|
|
54
|
+
<SectionTitle>Work Experience</SectionTitle>
|
|
55
|
+
{resume.work.map((job) => (
|
|
56
|
+
<ListItem
|
|
57
|
+
key={job.name}
|
|
58
|
+
title={job.position}
|
|
59
|
+
subtitle={job.name}
|
|
60
|
+
dateRange={<DateRange start={job.startDate} end={job.endDate} />}
|
|
61
|
+
location={job.location}
|
|
62
|
+
highlights={job.highlights}
|
|
63
|
+
/>
|
|
64
|
+
))}
|
|
65
|
+
</Section>
|
|
66
|
+
|
|
67
|
+
<Section id="skills">
|
|
68
|
+
<SectionTitle>Skills</SectionTitle>
|
|
69
|
+
{resume.skills.map((skill) => (
|
|
70
|
+
<div key={skill.name}>
|
|
71
|
+
<h3>{skill.name}</h3>
|
|
72
|
+
<BadgeList items={skill.keywords} />
|
|
73
|
+
</div>
|
|
74
|
+
))}
|
|
75
|
+
</Section>
|
|
76
|
+
</ThemeProvider>
|
|
77
|
+
);
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
export default Resume;
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
## Component Categories
|
|
84
|
+
|
|
85
|
+
### Core Primitives (7 components)
|
|
86
|
+
|
|
87
|
+
Basic building blocks for resume sections:
|
|
88
|
+
|
|
89
|
+
- `Section` - Semantic section wrapper with print optimization
|
|
90
|
+
- `SectionTitle` - Styled section headings
|
|
91
|
+
- `ListItem` - Experience/education entries with metadata
|
|
92
|
+
- `DateRange` - Smart date formatting with "Present" support
|
|
93
|
+
- `Badge` - Skill tags and keywords
|
|
94
|
+
- `BadgeList` - Multiple badges with consistent styling
|
|
95
|
+
- `ContactInfo` - Contact details with icons
|
|
96
|
+
- `Link` - Safe external links with security validation
|
|
97
|
+
|
|
98
|
+
### Layout Components (6 components)
|
|
99
|
+
|
|
100
|
+
Structure and organization:
|
|
101
|
+
|
|
102
|
+
- `GridLayout` - Multi-column responsive grids
|
|
103
|
+
- `SidebarLayout` - Two-column layout with sidebar
|
|
104
|
+
- `StackLayout` - Vertical stacking with spacing
|
|
105
|
+
- `CardLayout` - Card-based content containers
|
|
106
|
+
- `FlexLayout` - Flexible box layouts
|
|
107
|
+
- `TwoColumnMicroGrid` - Compact two-column grids
|
|
108
|
+
|
|
109
|
+
### Skills Components (6 components)
|
|
110
|
+
|
|
111
|
+
Visual skill representations:
|
|
112
|
+
|
|
113
|
+
- `SkillBar` - Progress bar visualization
|
|
114
|
+
- `SkillPill` - Pill-shaped skill badges
|
|
115
|
+
- `SkillRating` - Star or dot rating display
|
|
116
|
+
- `SkillGroup` - Grouped skill categories
|
|
117
|
+
- `SkillCloud` - Tag cloud visualization
|
|
118
|
+
- `SkillCategory` - Categorized skill lists
|
|
119
|
+
|
|
120
|
+
### Profile Components (4 components)
|
|
121
|
+
|
|
122
|
+
Header and contact sections:
|
|
123
|
+
|
|
124
|
+
- `Avatar` - Profile image with fallback
|
|
125
|
+
- `ProfileCard` - Complete profile header
|
|
126
|
+
- `ContactGrid` - Grid of contact methods
|
|
127
|
+
- `SocialLinks` - Social media icon links
|
|
128
|
+
|
|
129
|
+
### Typography Components (6 components)
|
|
130
|
+
|
|
131
|
+
Text styling and formatting:
|
|
132
|
+
|
|
133
|
+
- `Heading` - Semantic headings (h1-h6)
|
|
134
|
+
- `Text` - Body text with variants
|
|
135
|
+
- `Label` - Small labels and captions
|
|
136
|
+
- `SectionIntroParagraph` - Section introductions
|
|
137
|
+
- `QuoteStripe` - Pull quotes
|
|
138
|
+
- `HyphenationSafeParagraph` - Print-safe paragraphs
|
|
139
|
+
|
|
140
|
+
### Data Display Components (10 components)
|
|
141
|
+
|
|
142
|
+
Metrics and statistics:
|
|
143
|
+
|
|
144
|
+
- `ProgressCircle` - Circular progress indicators
|
|
145
|
+
- `StatCard` - Statistic cards
|
|
146
|
+
- `MetricBar` - Horizontal metric bars
|
|
147
|
+
- `MetricInline` - Inline metric display
|
|
148
|
+
- `MetricBullet` - Bullet-style metrics
|
|
149
|
+
- `MetricBulletList` - List of bullet metrics
|
|
150
|
+
- `KPIChipLine` - Key performance indicator chips
|
|
151
|
+
- `KPIChip` - Single KPI chip
|
|
152
|
+
- `KeyValueInline` - Inline key-value pairs
|
|
153
|
+
- `KeyValue` - Block key-value pairs
|
|
154
|
+
|
|
155
|
+
### Experience Components (4 components)
|
|
156
|
+
|
|
157
|
+
Work history layouts:
|
|
158
|
+
|
|
159
|
+
- `ExperienceCard` - Card-based job entries
|
|
160
|
+
- `ExperienceTimeline` - Timeline visualization
|
|
161
|
+
- `ExperienceGrid` - Grid layout for multiple jobs
|
|
162
|
+
- `ExperienceCompact` - Condensed job listings
|
|
163
|
+
|
|
164
|
+
### Header/Footer Components (11 components)
|
|
165
|
+
|
|
166
|
+
Page headers and footers:
|
|
167
|
+
|
|
168
|
+
- `HeaderCentered` - Centered header layout
|
|
169
|
+
- `HeaderSplit` - Two-column header
|
|
170
|
+
- `HeaderMinimal` - Minimal header design
|
|
171
|
+
- `CornerInitials` - Initials in corner
|
|
172
|
+
- `Footer` - Page footer
|
|
173
|
+
- `PageBreak` - Explicit page breaks
|
|
174
|
+
- `HeroNameBlock` - Large name display
|
|
175
|
+
- `ContactRowLine` - Single-line contact row
|
|
176
|
+
- `SectionRuleTitle` - Title with horizontal rule
|
|
177
|
+
- `SectionFlagTitle` - Title with accent flag
|
|
178
|
+
- `NameStackElegant` - Elegant name stack
|
|
179
|
+
|
|
180
|
+
### Timeline Components (4 components)
|
|
181
|
+
|
|
182
|
+
Chronological displays:
|
|
183
|
+
|
|
184
|
+
- `TimelineSection` - Full timeline section
|
|
185
|
+
- `TimelineItem` - Individual timeline entry
|
|
186
|
+
- `TimelineRuleMinimal` - Minimal timeline rule
|
|
187
|
+
- `TimelineInline` - Inline timeline display
|
|
188
|
+
|
|
189
|
+
### Quote/Testimonial Components (3 components)
|
|
190
|
+
|
|
191
|
+
Highlighted quotes:
|
|
192
|
+
|
|
193
|
+
- `PullQuote` - Sidebar pull quotes
|
|
194
|
+
- `Testimonial` - Testimonial cards
|
|
195
|
+
- `BlockQuote` - Block quote styling
|
|
196
|
+
|
|
197
|
+
### Certification/Award Components (4 components)
|
|
198
|
+
|
|
199
|
+
Credentials and honors:
|
|
200
|
+
|
|
201
|
+
- `CertificationBadge` - Certification badges
|
|
202
|
+
- `CertificationRow` - Row-based cert display
|
|
203
|
+
- `AwardCard` - Award cards
|
|
204
|
+
- `HonorsList` - List of honors
|
|
205
|
+
|
|
206
|
+
### Language Components (4 components)
|
|
207
|
+
|
|
208
|
+
Language proficiency:
|
|
209
|
+
|
|
210
|
+
- `LanguageBar` - Progress bar for proficiency
|
|
211
|
+
- `LanguageLevelBarLite` - Compact proficiency bar
|
|
212
|
+
- `LanguageGrid` - Grid of languages
|
|
213
|
+
- `ProficiencyScale` - Visual proficiency scale
|
|
214
|
+
|
|
215
|
+
### Publication/Portfolio Components (4 components)
|
|
216
|
+
|
|
217
|
+
Academic and creative work:
|
|
218
|
+
|
|
219
|
+
- `PublicationItem` - Publication entries
|
|
220
|
+
- `PublicationEntryPlain` - Plain publication format
|
|
221
|
+
- `PortfolioGrid` - Portfolio item grid
|
|
222
|
+
- `ProjectCard` - Project showcase cards
|
|
223
|
+
|
|
224
|
+
### Table Components (3 components)
|
|
225
|
+
|
|
226
|
+
Structured data:
|
|
227
|
+
|
|
228
|
+
- `SkillMatrix` - Skills matrix table
|
|
229
|
+
- `ComparisonTable` - Comparison tables
|
|
230
|
+
- `DataTable` - Generic data tables
|
|
231
|
+
|
|
232
|
+
### List Components (11 components)
|
|
233
|
+
|
|
234
|
+
Various list styles:
|
|
235
|
+
|
|
236
|
+
- `CheckList` - Checkmark lists
|
|
237
|
+
- `IconList` - Lists with icons
|
|
238
|
+
- `NumberedList` - Numbered lists
|
|
239
|
+
- `BulletList` - Bullet point lists
|
|
240
|
+
- `CompactList` - Condensed lists
|
|
241
|
+
- `AchievementListTight` - Tight achievement lists
|
|
242
|
+
- `AchievementListSpacious` - Spacious achievements
|
|
243
|
+
- `HangingBulletList` - Hanging indent bullets
|
|
244
|
+
- `ListDashCompact` - Dash-separated lists
|
|
245
|
+
- `MiniDotLeaderList` - Dot leader lists
|
|
246
|
+
- `DefinitionKeyline` - Definition lists
|
|
247
|
+
|
|
248
|
+
### Callout Components (3 components)
|
|
249
|
+
|
|
250
|
+
Highlighted content:
|
|
251
|
+
|
|
252
|
+
- `Callout` - Callout boxes
|
|
253
|
+
- `InfoBox` - Information boxes
|
|
254
|
+
- `HighlightCard` - Highlighted cards
|
|
255
|
+
|
|
256
|
+
### Visual Components (4 components)
|
|
257
|
+
|
|
258
|
+
Decorative elements:
|
|
259
|
+
|
|
260
|
+
- `BackgroundPattern` - Background patterns
|
|
261
|
+
- `ColorBlock` - Colored blocks
|
|
262
|
+
- `DividerVariants` - Various divider styles
|
|
263
|
+
- `BorderAccent` - Border accents
|
|
264
|
+
|
|
265
|
+
### Date Components (2 components)
|
|
266
|
+
|
|
267
|
+
Date formatting:
|
|
268
|
+
|
|
269
|
+
- `DateBadge` - Date badges
|
|
270
|
+
- `RelativeDate` - Relative date formatting
|
|
271
|
+
|
|
272
|
+
### Print Utilities (8 components)
|
|
273
|
+
|
|
274
|
+
Print optimization:
|
|
275
|
+
|
|
276
|
+
- `KeepTogether` - Prevent page breaks
|
|
277
|
+
- `ColumnBreak` - Force column breaks
|
|
278
|
+
- `PrintOnly` - Show only in print
|
|
279
|
+
- `ScreenOnly` - Show only on screen
|
|
280
|
+
- `PageHeaderLine` - Print headers
|
|
281
|
+
- `PageFooterLine` - Print footers
|
|
282
|
+
- `LetterheadBar` - Letterhead styling
|
|
283
|
+
- `SoftShadowEmulation` - Print-safe shadows
|
|
284
|
+
|
|
285
|
+
### Metadata Components (5 components)
|
|
286
|
+
|
|
287
|
+
Supplementary information:
|
|
288
|
+
|
|
289
|
+
- `InlineKicker` - Inline kickers
|
|
290
|
+
- `MetaRow` - Metadata rows
|
|
291
|
+
- `SubsectionLabel` - Subsection labels
|
|
292
|
+
- `GreyLabelCaps` - Small caps labels
|
|
293
|
+
- `SmallCapsHeading` - Small caps headings
|
|
294
|
+
|
|
295
|
+
### Container Components (4 components)
|
|
296
|
+
|
|
297
|
+
Content containers:
|
|
298
|
+
|
|
299
|
+
- `MutedPanel` - Muted background panels
|
|
300
|
+
- `AccentCalloutPanel` - Accent panels
|
|
301
|
+
- `SoftCardOutline` - Soft card outlines
|
|
302
|
+
- `RoleBlockFramed` - Framed role blocks
|
|
303
|
+
|
|
304
|
+
### Tag/Badge Components (2 components)
|
|
305
|
+
|
|
306
|
+
Tags and badges:
|
|
307
|
+
|
|
308
|
+
- `ToolTagRibbon` - Tool tag ribbons
|
|
309
|
+
- `BadgeRowOutline` - Outlined badge rows
|
|
310
|
+
|
|
311
|
+
## Design Tokens
|
|
312
|
+
|
|
313
|
+
Access design tokens for consistent theming:
|
|
314
|
+
|
|
315
|
+
```jsx
|
|
316
|
+
import { typography, colors, spacing, layout, radius, shadows } from '@jsonresume/core';
|
|
317
|
+
|
|
318
|
+
console.log(colors.primary); // 'var(--resume-color-primary)'
|
|
319
|
+
console.log(typography.fonts.sans); // 'var(--resume-font-sans)'
|
|
320
|
+
```
|
|
321
|
+
|
|
322
|
+
**Available token categories:**
|
|
323
|
+
|
|
324
|
+
- `typography` - Font families, sizes, weights, line heights
|
|
325
|
+
- `colors` - Primary, secondary, accent, muted, background colors
|
|
326
|
+
- `spacing` - Margins, padding, gaps
|
|
327
|
+
- `layout` - Max widths, container sizes
|
|
328
|
+
- `radius` - Border radius values
|
|
329
|
+
- `shadows` - Box shadow definitions
|
|
330
|
+
|
|
331
|
+
**Raw tokens** (for SSR/PDF generation):
|
|
332
|
+
|
|
333
|
+
```jsx
|
|
334
|
+
import { rawTokens } from '@jsonresume/core';
|
|
335
|
+
|
|
336
|
+
console.log(rawTokens.typography.fonts.sans);
|
|
337
|
+
// '"Helvetica Neue", Helvetica, Arial, sans-serif'
|
|
338
|
+
```
|
|
339
|
+
|
|
340
|
+
## Security Utilities
|
|
341
|
+
|
|
342
|
+
Protect against XSS and malicious URLs:
|
|
343
|
+
|
|
344
|
+
```jsx
|
|
345
|
+
import { safeUrl, sanitizeHtml, isExternalUrl, getLinkRel } from '@jsonresume/core';
|
|
346
|
+
|
|
347
|
+
// Validate URLs before rendering
|
|
348
|
+
const url = safeUrl(userProvidedUrl); // Returns safe URL or '#'
|
|
349
|
+
|
|
350
|
+
// Sanitize HTML content
|
|
351
|
+
const clean = sanitizeHtml(userHTML); // Strips dangerous tags/attributes
|
|
352
|
+
|
|
353
|
+
// Check if URL is external
|
|
354
|
+
if (isExternalUrl(url)) {
|
|
355
|
+
// Add external link indicators
|
|
356
|
+
}
|
|
357
|
+
|
|
358
|
+
// Get appropriate rel attribute
|
|
359
|
+
const rel = getLinkRel(url); // Returns 'noopener noreferrer' for external
|
|
360
|
+
```
|
|
361
|
+
|
|
362
|
+
**Best practices:**
|
|
363
|
+
|
|
364
|
+
- Always use `safeUrl()` for user-provided URLs
|
|
365
|
+
- Use `sanitizeHtml()` for any user HTML content
|
|
366
|
+
- Apply `getLinkRel()` to external links
|
|
367
|
+
|
|
368
|
+
## Calculation Helpers
|
|
369
|
+
|
|
370
|
+
Calculate resume metrics and statistics:
|
|
371
|
+
|
|
372
|
+
```jsx
|
|
373
|
+
import {
|
|
374
|
+
calculateTotalExperience,
|
|
375
|
+
countCompanies,
|
|
376
|
+
getHighestDegree,
|
|
377
|
+
isCurrentlyEmployed,
|
|
378
|
+
} from '@jsonresume/core';
|
|
379
|
+
|
|
380
|
+
const resume = { work: [...], education: [...] };
|
|
381
|
+
|
|
382
|
+
const experience = calculateTotalExperience(resume.work); // Years of experience
|
|
383
|
+
const companies = countCompanies(resume.work); // Number of companies
|
|
384
|
+
const degree = getHighestDegree(resume.education); // Highest degree
|
|
385
|
+
const employed = isCurrentlyEmployed(resume.work); // Boolean
|
|
386
|
+
```
|
|
387
|
+
|
|
388
|
+
**Available calculations:**
|
|
389
|
+
|
|
390
|
+
- `calculateTotalExperience(work)` - Total years of experience
|
|
391
|
+
- `calculateCurrentRoleExperience(work)` - Current role duration
|
|
392
|
+
- `countCompanies(work)` - Number of companies worked at
|
|
393
|
+
- `countProjects(projects)` - Number of projects
|
|
394
|
+
- `countPublications(publications)` - Number of publications
|
|
395
|
+
- `countAwards(awards)` - Number of awards
|
|
396
|
+
- `countTotalSkills(skills)` - Total skill count
|
|
397
|
+
- `countSkillCategories(skills)` - Number of skill categories
|
|
398
|
+
- `countLanguages(languages)` - Number of languages
|
|
399
|
+
- `calculateVolunteerYears(volunteer)` - Years of volunteer work
|
|
400
|
+
- `calculateEducationYears(education)` - Years of education
|
|
401
|
+
- `getHighestDegree(education)` - Highest degree earned
|
|
402
|
+
- `countCareerPositions(work)` - Total positions held
|
|
403
|
+
- `getCareerProgressionRate(work)` - Career progression rate
|
|
404
|
+
- `countTotalHighlights(work)` - Total highlights across jobs
|
|
405
|
+
- `getUniqueIndustries(work)` - Unique industries worked in
|
|
406
|
+
- `getCurrentEmployer(work)` - Current employer name
|
|
407
|
+
- `isCurrentlyEmployed(work)` - Employment status
|
|
408
|
+
- `calculateKeyMetrics(resume)` - All metrics in one object
|
|
409
|
+
|
|
410
|
+
## Server-Side Rendering (SSR)
|
|
411
|
+
|
|
412
|
+
Full SSR support with styled-components:
|
|
413
|
+
|
|
414
|
+
```jsx
|
|
415
|
+
import { renderToString } from 'react-dom/server';
|
|
416
|
+
import { ServerStyleSheet } from 'styled-components';
|
|
417
|
+
import Resume from './Resume';
|
|
418
|
+
|
|
419
|
+
export function render(resume) {
|
|
420
|
+
const sheet = new ServerStyleSheet();
|
|
421
|
+
|
|
422
|
+
try {
|
|
423
|
+
const html = renderToString(sheet.collectStyles(<Resume resume={resume} />));
|
|
424
|
+
const styleTags = sheet.getStyleTags();
|
|
425
|
+
|
|
426
|
+
return `
|
|
427
|
+
<!DOCTYPE html>
|
|
428
|
+
<html>
|
|
429
|
+
<head>
|
|
430
|
+
<meta charset="utf-8">
|
|
431
|
+
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
432
|
+
<title>${resume.basics.name} - Resume</title>
|
|
433
|
+
${styleTags}
|
|
434
|
+
</head>
|
|
435
|
+
<body>
|
|
436
|
+
${html}
|
|
437
|
+
</body>
|
|
438
|
+
</html>
|
|
439
|
+
`;
|
|
440
|
+
} finally {
|
|
441
|
+
sheet.seal();
|
|
442
|
+
}
|
|
443
|
+
}
|
|
444
|
+
```
|
|
445
|
+
|
|
446
|
+
**IMPORTANT:** Without `ServerStyleSheet`, styled-components won't inject CSS and your theme will have no styles!
|
|
447
|
+
|
|
448
|
+
## Theme Building Tutorial
|
|
449
|
+
|
|
450
|
+
### Step 1: Create Theme Package
|
|
451
|
+
|
|
452
|
+
```bash
|
|
453
|
+
mkdir packages/jsonresume-theme-myname
|
|
454
|
+
cd packages/jsonresume-theme-myname
|
|
455
|
+
pnpm init
|
|
456
|
+
```
|
|
457
|
+
|
|
458
|
+
### Step 2: Configure package.json
|
|
459
|
+
|
|
460
|
+
```json
|
|
461
|
+
{
|
|
462
|
+
"name": "jsonresume-theme-myname",
|
|
463
|
+
"version": "1.0.0",
|
|
464
|
+
"main": "./src/index.js",
|
|
465
|
+
"peerDependencies": {
|
|
466
|
+
"react": "^18.0.0 || ^19.0.0",
|
|
467
|
+
"react-dom": "^18.0.0 || ^19.0.0"
|
|
468
|
+
},
|
|
469
|
+
"dependencies": {
|
|
470
|
+
"@jsonresume/core": "workspace:*",
|
|
471
|
+
"styled-components": "workspace:*"
|
|
472
|
+
}
|
|
473
|
+
}
|
|
474
|
+
```
|
|
475
|
+
|
|
476
|
+
### Step 3: Create Resume Component
|
|
477
|
+
|
|
478
|
+
```jsx
|
|
479
|
+
// src/Resume.jsx
|
|
480
|
+
import React from 'react';
|
|
481
|
+
import {
|
|
482
|
+
ThemeProvider,
|
|
483
|
+
Section,
|
|
484
|
+
SectionTitle,
|
|
485
|
+
ProfileCard,
|
|
486
|
+
ExperienceTimeline,
|
|
487
|
+
BadgeList,
|
|
488
|
+
} from '@jsonresume/core';
|
|
489
|
+
|
|
490
|
+
export default function Resume({ resume }) {
|
|
491
|
+
const { basics, work, education, skills } = resume;
|
|
492
|
+
|
|
493
|
+
return (
|
|
494
|
+
<ThemeProvider>
|
|
495
|
+
<ProfileCard
|
|
496
|
+
name={basics.name}
|
|
497
|
+
label={basics.label}
|
|
498
|
+
email={basics.email}
|
|
499
|
+
phone={basics.phone}
|
|
500
|
+
url={basics.url}
|
|
501
|
+
summary={basics.summary}
|
|
502
|
+
/>
|
|
503
|
+
|
|
504
|
+
<Section id="work">
|
|
505
|
+
<SectionTitle>Experience</SectionTitle>
|
|
506
|
+
<ExperienceTimeline items={work} />
|
|
507
|
+
</Section>
|
|
508
|
+
|
|
509
|
+
<Section id="education">
|
|
510
|
+
<SectionTitle>Education</SectionTitle>
|
|
511
|
+
{education.map((edu) => (
|
|
512
|
+
<div key={edu.institution}>
|
|
513
|
+
<h3>{edu.institution}</h3>
|
|
514
|
+
<p>
|
|
515
|
+
{edu.studyType} in {edu.area}
|
|
516
|
+
</p>
|
|
517
|
+
</div>
|
|
518
|
+
))}
|
|
519
|
+
</Section>
|
|
520
|
+
|
|
521
|
+
<Section id="skills">
|
|
522
|
+
<SectionTitle>Skills</SectionTitle>
|
|
523
|
+
{skills.map((skill) => (
|
|
524
|
+
<div key={skill.name}>
|
|
525
|
+
<h4>{skill.name}</h4>
|
|
526
|
+
<BadgeList items={skill.keywords} />
|
|
527
|
+
</div>
|
|
528
|
+
))}
|
|
529
|
+
</Section>
|
|
530
|
+
</ThemeProvider>
|
|
531
|
+
);
|
|
532
|
+
}
|
|
533
|
+
```
|
|
534
|
+
|
|
535
|
+
### Step 4: Create Render Function
|
|
536
|
+
|
|
537
|
+
```jsx
|
|
538
|
+
// src/index.js
|
|
539
|
+
import { renderToString } from 'react-dom/server';
|
|
540
|
+
import { ServerStyleSheet } from 'styled-components';
|
|
541
|
+
import Resume from './Resume.jsx';
|
|
542
|
+
|
|
543
|
+
export function render(resume) {
|
|
544
|
+
const sheet = new ServerStyleSheet();
|
|
545
|
+
|
|
546
|
+
try {
|
|
547
|
+
const html = renderToString(sheet.collectStyles(<Resume resume={resume} />));
|
|
548
|
+
const styles = sheet.getStyleTags();
|
|
549
|
+
|
|
550
|
+
return `
|
|
551
|
+
<!DOCTYPE html>
|
|
552
|
+
<html>
|
|
553
|
+
<head>
|
|
554
|
+
<meta charset="utf-8">
|
|
555
|
+
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
556
|
+
<title>${resume.basics.name} - Resume</title>
|
|
557
|
+
${styles}
|
|
558
|
+
</head>
|
|
559
|
+
<body>
|
|
560
|
+
${html}
|
|
561
|
+
</body>
|
|
562
|
+
</html>
|
|
563
|
+
`;
|
|
564
|
+
} finally {
|
|
565
|
+
sheet.seal();
|
|
566
|
+
}
|
|
567
|
+
}
|
|
568
|
+
```
|
|
569
|
+
|
|
570
|
+
### Step 5: Register Theme
|
|
571
|
+
|
|
572
|
+
Add to `apps/registry/lib/formatters/template/themeConfig.js`:
|
|
573
|
+
|
|
574
|
+
```javascript
|
|
575
|
+
import * as myTheme from 'jsonresume-theme-myname';
|
|
576
|
+
|
|
577
|
+
export const THEMES = {
|
|
578
|
+
// ...
|
|
579
|
+
myname: {
|
|
580
|
+
name: 'My Theme',
|
|
581
|
+
theme: myTheme,
|
|
582
|
+
description: 'A beautiful custom theme',
|
|
583
|
+
},
|
|
584
|
+
};
|
|
585
|
+
```
|
|
586
|
+
|
|
587
|
+
## Examples
|
|
588
|
+
|
|
589
|
+
### Complete Resume
|
|
590
|
+
|
|
591
|
+
```jsx
|
|
592
|
+
import Resume from 'jsonresume-theme-myname';
|
|
593
|
+
|
|
594
|
+
const resumeData = {
|
|
595
|
+
basics: {
|
|
596
|
+
name: 'John Doe',
|
|
597
|
+
label: 'Software Engineer',
|
|
598
|
+
email: 'john@example.com',
|
|
599
|
+
// ...
|
|
600
|
+
},
|
|
601
|
+
work: [
|
|
602
|
+
{
|
|
603
|
+
name: 'TechCorp',
|
|
604
|
+
position: 'Senior Engineer',
|
|
605
|
+
startDate: '2020-01',
|
|
606
|
+
endDate: null,
|
|
607
|
+
highlights: ['Led team of 6', 'Reduced costs by $200k'],
|
|
608
|
+
},
|
|
609
|
+
],
|
|
610
|
+
// ...
|
|
611
|
+
};
|
|
612
|
+
|
|
613
|
+
const html = Resume.render(resumeData);
|
|
614
|
+
```
|
|
615
|
+
|
|
616
|
+
### Custom Styling
|
|
617
|
+
|
|
618
|
+
```jsx
|
|
619
|
+
import styled from 'styled-components';
|
|
620
|
+
import { Section as BaseSection } from '@jsonresume/core';
|
|
621
|
+
|
|
622
|
+
const CustomSection = styled(BaseSection)`
|
|
623
|
+
background: linear-gradient(to right, #f0f0f0, #ffffff);
|
|
624
|
+
padding: 2rem;
|
|
625
|
+
border-radius: 8px;
|
|
626
|
+
`;
|
|
627
|
+
```
|
|
628
|
+
|
|
629
|
+
## TypeScript Support
|
|
630
|
+
|
|
631
|
+
TypeScript definitions are included:
|
|
632
|
+
|
|
633
|
+
```typescript
|
|
634
|
+
import { Section, SectionTitle, ListItem } from '@jsonresume/core';
|
|
635
|
+
import type { Resume } from '@jsonresume/core';
|
|
636
|
+
|
|
637
|
+
function MyResume({ resume }: { resume: Resume }) {
|
|
638
|
+
// Full type safety
|
|
639
|
+
}
|
|
640
|
+
```
|
|
641
|
+
|
|
642
|
+
## Browser Support
|
|
643
|
+
|
|
644
|
+
- Chrome 90+
|
|
645
|
+
- Firefox 88+
|
|
646
|
+
- Safari 14+
|
|
647
|
+
- Edge 90+
|
|
648
|
+
|
|
649
|
+
**Requirements:**
|
|
650
|
+
|
|
651
|
+
- CSS Custom Properties support
|
|
652
|
+
- ES6+ JavaScript
|
|
653
|
+
|
|
654
|
+
## Performance
|
|
655
|
+
|
|
656
|
+
- **Bundle Size:** ~15KB minified + gzipped (core components only)
|
|
657
|
+
- **Tree-Shakeable:** Import only what you need
|
|
658
|
+
- **SSR Optimized:** Fast server-side rendering
|
|
659
|
+
- **Print Optimized:** Perfect PDF generation
|
|
660
|
+
|
|
661
|
+
## Contributing
|
|
662
|
+
|
|
663
|
+
Contributions welcome! Please follow these guidelines:
|
|
664
|
+
|
|
665
|
+
1. **Add Tests:** All new components must have tests
|
|
666
|
+
2. **Follow Conventions:** Use existing naming patterns
|
|
667
|
+
3. **Document:** Add JSDoc comments and examples
|
|
668
|
+
4. **Keep Components Small:** Under 200 lines per file
|
|
669
|
+
5. **Use Styled Components:** Consistent with existing code
|
|
670
|
+
|
|
671
|
+
## Related Packages
|
|
672
|
+
|
|
673
|
+
- [jsonresume-theme-standard](../jsonresume-theme-standard) - Classic theme
|
|
674
|
+
- [jsonresume-theme-professional](../jsonresume-theme-professional) - Professional theme
|
|
675
|
+
- [jsonresume-theme-spartacus](../jsonresume-theme-spartacus) - Spartacus theme
|
|
676
|
+
|
|
677
|
+
## Support
|
|
678
|
+
|
|
679
|
+
- **Issues:** [GitHub Issues](https://github.com/jsonresume/jsonresume.org/issues)
|
|
680
|
+
- **Discussions:** [GitHub Discussions](https://github.com/jsonresume/jsonresume.org/discussions)
|
|
681
|
+
- **Documentation:** [jsonresume.org](https://jsonresume.org)
|
|
682
|
+
|
|
683
|
+
## License
|
|
684
|
+
|
|
685
|
+
MIT
|
|
686
|
+
|
|
687
|
+
---
|
|
688
|
+
|
|
689
|
+
**Part of the [JSON Resume](https://jsonresume.org) ecosystem** - Open source resume standard used by thousands of developers worldwide.
|