create-foliokit 0.0.0-stage → 1.0.1

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.
Files changed (34) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +111 -2
  3. package/bin/index.js +6 -0
  4. package/package.json +50 -4
  5. package/src/cli.js +111 -0
  6. package/src/generator.js +133 -0
  7. package/src/prompts.js +44 -0
  8. package/src/utils/errors.js +7 -0
  9. package/src/utils/paths.js +12 -0
  10. package/src/utils/progress.js +5 -0
  11. package/src/utils/project-name.js +30 -0
  12. package/templates/default/data.ts +169 -0
  13. package/templates/default/index.html +23 -0
  14. package/templates/default/package-lock.json +1280 -0
  15. package/templates/default/package.json +28 -0
  16. package/templates/default/public/avatar-placeholder.png +0 -0
  17. package/templates/default/public/experience-logo-placeholder.png +0 -0
  18. package/templates/default/public/project-placeholder.png +0 -0
  19. package/templates/default/public/robots.txt +2 -0
  20. package/templates/default/scripts/generate-seo.mjs +34 -0
  21. package/templates/default/src/App.tsx +582 -0
  22. package/templates/default/src/BrandIcon.tsx +36 -0
  23. package/templates/default/src/ProjectMagazineGallery.css +90 -0
  24. package/templates/default/src/ProjectMagazineGallery.tsx +218 -0
  25. package/templates/default/src/main.tsx +28 -0
  26. package/templates/default/src/styles.css +501 -0
  27. package/templates/default/src/utils.ts +2 -0
  28. package/templates/default/src/vite-env.d.ts +1 -0
  29. package/templates/default/tests/portfolio.test.js +96 -0
  30. package/templates/default/tsconfig.app.json +21 -0
  31. package/templates/default/tsconfig.json +7 -0
  32. package/templates/default/tsconfig.node.json +16 -0
  33. package/templates/default/types.ts +73 -0
  34. package/templates/default/vite.config.ts +38 -0
@@ -0,0 +1,36 @@
1
+ import { useState } from 'react'
2
+
3
+ type Props = {
4
+ name: string
5
+ src: string
6
+ width: number
7
+ height: number
8
+ className?: string
9
+ loading?: 'eager' | 'lazy'
10
+ }
11
+
12
+ function shortLabel(name: string) {
13
+ const labels: Record<string, string> = {
14
+ GitHub: 'GH',
15
+ }
16
+ if (labels[name]) return labels[name]
17
+ return name.split(/[^a-z0-9]+/i).filter(Boolean).map((part) => part[0]).join('').slice(0, 2).toUpperCase()
18
+ }
19
+
20
+ function BrandIcon({ name, src, width, height, className, loading = 'lazy' }: Props) {
21
+ const [unavailable, setUnavailable] = useState(false)
22
+ if (unavailable) {
23
+ return (
24
+ <span
25
+ className={`brand-icon-fallback${className ? ` ${className}` : ''}`}
26
+ style={{ width, height, flexBasis: width }}
27
+ aria-hidden="true"
28
+ >
29
+ {shortLabel(name)}
30
+ </span>
31
+ )
32
+ }
33
+ return <img className={className} src={src} alt="" width={width} height={height} loading={loading} onError={() => setUnavailable(true)} />
34
+ }
35
+
36
+ export default BrandIcon
@@ -0,0 +1,90 @@
1
+ .project-magazine-gallery {
2
+ --magazine-gold: #D6B77A;
3
+ padding: 2px 0 14px;
4
+ }
5
+
6
+ .magazine-viewport {
7
+ position: relative;
8
+ width: 100%;
9
+ height: 320px;
10
+ overflow: hidden;
11
+ perspective: 1100px;
12
+ perspective-origin: 50% 43%;
13
+ touch-action: pan-y;
14
+ overscroll-behavior-x: contain;
15
+ outline: none;
16
+ user-select: none;
17
+ -webkit-tap-highlight-color: transparent;
18
+ }
19
+ .magazine-viewport:focus-visible { outline: 1px solid color-mix(in srgb, var(--magazine-gold) 55%, transparent); outline-offset: -2px; }
20
+ .magazine-viewport.is-dragging { cursor: grabbing; }
21
+ .magazine-viewport.is-dragging .magazine-cover { cursor: grabbing; transition: none; }
22
+
23
+ .magazine-cover {
24
+ --tilt-x: 0deg;
25
+ --tilt-y: 0deg;
26
+ position: absolute;
27
+ top: 15px;
28
+ left: 50%;
29
+ display: flex;
30
+ width: min(250px, 40%);
31
+ height: 270px;
32
+ flex-direction: column;
33
+ padding: 0;
34
+ overflow: hidden;
35
+ border: 1px solid rgba(214, 183, 122, .25);
36
+ border-radius: 5px;
37
+ color: var(--warm-white);
38
+ background: #070707;
39
+ box-shadow: 0 15px 34px rgba(0, 0, 0, .52), 0 0 0 1px rgba(255, 255, 255, .025) inset, 1px 0 rgba(214, 183, 122, .13) inset;
40
+ cursor: grab;
41
+ opacity: .68;
42
+ transform: translate3d(calc(-50% + var(--translate-x) + var(--drag-x, 0px) + var(--hover-shift)), var(--hover-lift), var(--depth-z)) rotateY(calc(var(--rotate-y) + var(--tilt-y))) rotateX(var(--tilt-x)) scale(var(--card-scale));
43
+ transform-style: preserve-3d;
44
+ transition: transform 460ms cubic-bezier(.22, .8, .22, 1), opacity 360ms ease, box-shadow 400ms ease, border-color 400ms ease;
45
+ animation: magazine-cover-appear 750ms cubic-bezier(.2, .72, .18, 1) var(--card-delay) both;
46
+ -webkit-user-select: none;
47
+ }
48
+ .magazine-cover.is-active { z-index: 4 !important; opacity: 1; cursor: pointer; border-color: rgba(214, 183, 122, .54); box-shadow: 0 20px 44px rgba(0, 0, 0, .62), 0 0 22px rgba(214, 183, 122, .1), 0 0 0 1px rgba(214, 183, 122, .06) inset; }
49
+ .magazine-cover.is-hovered { opacity: 1; border-color: rgba(214, 183, 122, .68); box-shadow: 0 24px 50px rgba(0, 0, 0, .66), 0 0 28px rgba(214, 183, 122, .16), 0 0 0 1px rgba(214, 183, 122, .1) inset; }
50
+ .magazine-cover.is-hidden { pointer-events: none; opacity: 0; }
51
+ .magazine-cover:focus-visible { outline: 1px solid var(--magazine-gold); outline-offset: 3px; }
52
+ .magazine-cover-image-wrap { position: relative; display: block; height: 56%; flex: 0 0 56%; overflow: hidden; background: #101010; transform: translateZ(8px); }
53
+ .magazine-cover-image-wrap::after { position: absolute; inset: 0; border-bottom: 1px solid rgba(214, 183, 122, .22); background: linear-gradient(180deg, rgba(0, 0, 0, .24), transparent 35%, rgba(0, 0, 0, .16)); content: ''; pointer-events: none; }
54
+ .magazine-cover-image { display: block; width: 100%; height: 100%; object-fit: cover; filter: grayscale(1) brightness(.82); transition: filter 480ms ease, transform 700ms cubic-bezier(.2, .72, .18, 1); pointer-events: none; }
55
+ .magazine-cover-image-placeholder { display: grid; width: 100%; height: 100%; place-items: center; background: radial-gradient(circle at 35% 25%, #242424, #050505 72%); color: #e5cf9c; font: 600 46px/1 var(--heading-font); }
56
+ .magazine-cover.is-active .magazine-cover-image, .magazine-cover.is-hovered .magazine-cover-image { filter: grayscale(0) brightness(.98); transform: scale(1.035); }
57
+ .magazine-cover-info { display: flex; min-height: 0; flex: 1; flex-direction: column; align-items: flex-start; padding: 12px 14px 10px; text-align: left; transform: translateZ(14px); }
58
+ .magazine-cover-meta { display: flex; width: 100%; align-items: center; justify-content: space-between; gap: 6px; color: var(--muted); font: 8px/1.2 var(--body-font); letter-spacing: .035em; text-transform: uppercase; }
59
+ .magazine-cover-meta span { overflow: hidden; color: var(--muted); text-overflow: ellipsis; white-space: nowrap; }
60
+ .magazine-cover-title { margin-top: 7px; color: var(--warm-white); font: 600 17px/1.1 var(--heading-font); letter-spacing: -.035em; }
61
+ .magazine-cover-description { display: -webkit-box; max-height: 0; overflow: hidden; color: var(--muted); font: 10px/1.45 var(--body-font); opacity: 0; -webkit-box-orient: vertical; -webkit-line-clamp: 3; transition: max-height 360ms ease, opacity 280ms ease, margin 280ms ease; }
62
+ .magazine-cover.is-active .magazine-cover-description, .magazine-cover.is-hovered .magazine-cover-description, .magazine-cover:focus-visible .magazine-cover-description { max-height: 48px; margin-top: 6px; opacity: 1; }
63
+ .magazine-cover-hint { display: flex; width: 100%; align-items: center; justify-content: space-between; margin-top: auto; padding-top: 5px; color: var(--magazine-gold); font: 600 8px/1 var(--heading-font); letter-spacing: .1em; opacity: .78; }
64
+ .magazine-cover-hint span { font-size: 13px; line-height: .8; }
65
+
66
+ @keyframes magazine-cover-appear {
67
+ from { opacity: 0; filter: blur(3px); }
68
+ to { filter: blur(0); }
69
+ }
70
+
71
+ @media (min-width: 1024px) {
72
+ .magazine-viewport { height: 345px; perspective: 1250px; }
73
+ .magazine-cover { top: 18px; width: min(275px, 36%); height: 292px; }
74
+ }
75
+ @media (min-width: 768px) and (max-width: 1023px) {
76
+ .magazine-viewport { height: 315px; perspective: 1000px; }
77
+ .magazine-cover { top: 16px; width: min(238px, 42%); height: 267px; }
78
+ }
79
+ @media (max-width: 767px) {
80
+ .project-magazine-gallery { padding: 0 0 12px; }
81
+ .magazine-viewport { height: 300px; perspective: 850px; perspective-origin: 50% 42%; }
82
+ .magazine-cover { top: 14px; width: min(238px, 69%); height: 260px; border-radius: 4px; }
83
+ .magazine-cover-image-wrap { height: 53%; flex-basis: 53%; }
84
+ .magazine-cover-info { padding: 10px 12px 9px; }
85
+ .magazine-cover-description { font-size: 9px; }
86
+ .magazine-cover.is-active .magazine-cover-description { max-height: 52px; }
87
+ }
88
+ @media (prefers-reduced-motion: reduce) {
89
+ .magazine-cover, .magazine-cover-image, .magazine-cover-description { animation: none !important; transition-duration: .01ms !important; }
90
+ }
@@ -0,0 +1,218 @@
1
+ import { useEffect, useRef, useState, type CSSProperties, type PointerEvent, type KeyboardEvent, type WheelEvent } from 'react'
2
+ import { projectCardId } from './utils'
3
+ import type { Project } from '../types.js'
4
+ import './ProjectMagazineGallery.css'
5
+
6
+ type Props = { projects: Project[] }
7
+
8
+ // Gallery-specific labels stay beside the gallery component.
9
+ const galleryUi = {
10
+ carouselLabel: 'Featured project carousel',
11
+ galleryHelp: 'Project gallery. Swipe, drag, or use a horizontal trackpad gesture to browse. Use the left and right arrow keys while focused.',
12
+ projectDetails: 'Open {project} project details',
13
+ viewProject: 'VIEW PROJECT',
14
+ }
15
+
16
+ function getOffset(index: number, activeIndex: number, count: number) {
17
+ let offset = index - activeIndex
18
+ if (offset > count / 2) offset -= count
19
+ if (offset < -count / 2) offset += count
20
+ return offset
21
+ }
22
+
23
+ function ProjectMagazineGallery({ projects }: Props) {
24
+ const [activeIndex, setActiveIndex] = useState(0)
25
+ const [hoverIndex, setHoverIndex] = useState<number | null>(null)
26
+ const [dragX, setDragX] = useState(0)
27
+ const [isDragging, setIsDragging] = useState(false)
28
+ const [reducedMotion, setReducedMotion] = useState(false)
29
+ const dragStart = useRef<number | null>(null)
30
+ const wasDragged = useRef(false)
31
+ const clickResetTimer = useRef<number | undefined>(undefined)
32
+ const wheelDelta = useRef(0)
33
+ const wheelGestureHandled = useRef(false)
34
+ const wheelGestureTimer = useRef<number | undefined>(undefined)
35
+
36
+ useEffect(() => {
37
+ const query = window.matchMedia('(prefers-reduced-motion: reduce)')
38
+ const update = () => setReducedMotion(query.matches)
39
+ update()
40
+ query.addEventListener('change', update)
41
+ return () => {
42
+ query.removeEventListener('change', update)
43
+ window.clearTimeout(clickResetTimer.current)
44
+ window.clearTimeout(wheelGestureTimer.current)
45
+ }
46
+ }, [])
47
+
48
+ if (projects.length === 0) return null
49
+
50
+ const goTo = (nextIndex: number) => {
51
+ setActiveIndex((nextIndex + projects.length) % projects.length)
52
+ setHoverIndex(null)
53
+ }
54
+
55
+ const openProject = (index: number) => {
56
+ setActiveIndex(index)
57
+ document.getElementById(projectCardId(projects[index].name))?.scrollIntoView({
58
+ behavior: reducedMotion ? 'auto' : 'smooth',
59
+ block: 'center',
60
+ })
61
+ }
62
+
63
+ const handlePointerDown = (event: PointerEvent<HTMLDivElement>) => {
64
+ if (event.pointerType === 'mouse' && event.button !== 0) return
65
+ dragStart.current = event.clientX
66
+ setDragX(0)
67
+ const cover = (event.target as Element | null)?.closest<HTMLButtonElement>('.magazine-cover')
68
+ try {
69
+ (cover ?? event.currentTarget).setPointerCapture(event.pointerId)
70
+ } catch {
71
+ // Pointer capture may be unavailable on synthetic or cancelled pointer events.
72
+ }
73
+ }
74
+
75
+ const handlePointerMove = (event: PointerEvent<HTMLDivElement>) => {
76
+ if (dragStart.current === null) return
77
+ const delta = event.clientX - dragStart.current
78
+ setDragX(delta)
79
+ if (Math.abs(delta) > 8) setIsDragging(true)
80
+ }
81
+
82
+ const finishDrag = (event: PointerEvent<HTMLDivElement>) => {
83
+ if (dragStart.current === null) return
84
+ if (event.type === 'pointercancel') {
85
+ dragStart.current = null
86
+ setIsDragging(false)
87
+ setDragX(0)
88
+ return
89
+ }
90
+ const delta = event.clientX - dragStart.current
91
+ if (Math.abs(delta) > 48) {
92
+ wasDragged.current = true
93
+ goTo(activeIndex + (delta < 0 ? 1 : -1))
94
+ window.clearTimeout(clickResetTimer.current)
95
+ clickResetTimer.current = window.setTimeout(() => { wasDragged.current = false }, 140)
96
+ }
97
+ dragStart.current = null
98
+ setIsDragging(false)
99
+ setDragX(0)
100
+ }
101
+
102
+ const handleWheel = (event: WheelEvent<HTMLDivElement>) => {
103
+ if (Math.abs(event.deltaX) <= Math.abs(event.deltaY)) return
104
+ event.preventDefault()
105
+ window.clearTimeout(wheelGestureTimer.current)
106
+ wheelGestureTimer.current = window.setTimeout(() => {
107
+ wheelDelta.current = 0
108
+ wheelGestureHandled.current = false
109
+ }, 280)
110
+ if (wheelGestureHandled.current) return
111
+ wheelDelta.current += event.deltaX
112
+ if (Math.abs(wheelDelta.current) < 36) return
113
+ goTo(activeIndex + (wheelDelta.current > 0 ? 1 : -1))
114
+ wheelDelta.current = 0
115
+ wheelGestureHandled.current = true
116
+ }
117
+
118
+ const handleKeyDown = (event: KeyboardEvent<HTMLDivElement>) => {
119
+ if (event.key === 'ArrowRight') { event.preventDefault(); goTo(activeIndex + 1) }
120
+ if (event.key === 'ArrowLeft') { event.preventDefault(); goTo(activeIndex - 1) }
121
+ if (event.key === 'Home') { event.preventDefault(); goTo(0) }
122
+ if (event.key === 'End') { event.preventDefault(); goTo(projects.length - 1) }
123
+ }
124
+
125
+ const viewportStyle = { '--drag-x': `${dragX}px` } as CSSProperties
126
+
127
+ return (
128
+ <section className="project-magazine-gallery" aria-label={galleryUi.carouselLabel}>
129
+ <div
130
+ className={`magazine-viewport${isDragging ? ' is-dragging' : ''}`}
131
+ style={viewportStyle}
132
+ role="region"
133
+ aria-roledescription="project carousel"
134
+ aria-label={galleryUi.galleryHelp}
135
+ tabIndex={0}
136
+ onKeyDown={handleKeyDown}
137
+ onWheel={handleWheel}
138
+ onPointerDown={handlePointerDown}
139
+ onPointerMove={handlePointerMove}
140
+ onPointerUp={finishDrag}
141
+ onPointerCancel={finishDrag}
142
+ >
143
+ {projects.map((project, index) => {
144
+ const offset = getOffset(index, activeIndex, projects.length)
145
+ const distance = Math.abs(offset)
146
+ const isActive = index === activeIndex
147
+ const isHovered = index === hoverIndex
148
+ const hoverShift = hoverIndex !== null && index !== hoverIndex ? (index < hoverIndex ? '-9px' : '9px') : '0px'
149
+ const cardStyle = {
150
+ '--translate-x': offset === 0 ? '0%' : offset < 0 ? `${Math.max(-96, offset * 76)}%` : `${Math.min(96, offset * 76)}%`,
151
+ '--depth-z': `${-distance * 74}px`,
152
+ '--rotate-y': `${offset * -11}deg`,
153
+ '--card-scale': `${Math.max(.76, 1 - distance * .1)}`,
154
+ '--hover-lift': isHovered && !reducedMotion ? '24px' : '0px',
155
+ '--hover-shift': hoverShift,
156
+ '--card-delay': `${index * 110}ms`,
157
+ zIndex: projects.length - distance,
158
+ } as CSSProperties
159
+
160
+ const pointerTilt = (event: PointerEvent<HTMLButtonElement>) => {
161
+ if (event.pointerType !== 'mouse' || reducedMotion || isDragging) return
162
+ const bounds = event.currentTarget.getBoundingClientRect()
163
+ const relX = (event.clientX - bounds.left) / bounds.width - .5
164
+ const relY = (event.clientY - bounds.top) / bounds.height - .5
165
+ event.currentTarget.style.setProperty('--tilt-y', `${relX * 5}deg`)
166
+ event.currentTarget.style.setProperty('--tilt-x', `${-relY * 4}deg`)
167
+ }
168
+
169
+ const clearTilt = (event: PointerEvent<HTMLButtonElement>) => {
170
+ event.currentTarget.style.removeProperty('--tilt-y')
171
+ event.currentTarget.style.removeProperty('--tilt-x')
172
+ setHoverIndex(null)
173
+ }
174
+
175
+ return (
176
+ <button
177
+ className={`magazine-cover${isActive ? ' is-active' : ''}${isHovered ? ' is-hovered' : ''}${distance > 1 ? ' is-hidden' : ''}`}
178
+ key={project.name}
179
+ data-featured={project.featured || undefined}
180
+ type="button"
181
+ style={cardStyle}
182
+ aria-label={galleryUi.projectDetails.replace('{project}', project.name)}
183
+ aria-hidden={distance > 1}
184
+ tabIndex={distance > 1 ? -1 : 0}
185
+ onPointerEnter={(event) => { if (event.pointerType === 'mouse') setHoverIndex(index) }}
186
+ onPointerMove={pointerTilt}
187
+ onPointerLeave={clearTilt}
188
+ onFocus={() => { setActiveIndex(index); setHoverIndex(index) }}
189
+ onBlur={() => setHoverIndex(null)}
190
+ onClick={() => {
191
+ if (wasDragged.current) { wasDragged.current = false; return }
192
+ openProject(index)
193
+ }}
194
+ >
195
+ <span className="magazine-cover-image-wrap">
196
+ {project.image ? <>
197
+ <img src={project.image} alt={project.imageAlt ?? `${project.name} project cover`} className="magazine-cover-image" loading="lazy" draggable={false} onError={(event) => { event.currentTarget.hidden = true; const fallback = event.currentTarget.nextElementSibling; if (fallback instanceof HTMLElement) fallback.hidden = false }} />
198
+ <span className="magazine-cover-image-placeholder" aria-hidden="true" hidden>{project.name.slice(0, 2).toUpperCase()}</span>
199
+ </> : <span className="magazine-cover-image-placeholder" aria-hidden="true">{project.name.slice(0, 2).toUpperCase()}</span>}
200
+ </span>
201
+ <span className="magazine-cover-info">
202
+ <span className="magazine-cover-meta">
203
+ <span>{project.category}</span>
204
+ </span>
205
+ <span className="magazine-cover-title">{project.name}</span>
206
+ <span className="magazine-cover-description">{project.description}</span>
207
+ <span className="magazine-cover-hint">{galleryUi.viewProject} <span aria-hidden="true">↗</span></span>
208
+ </span>
209
+ </button>
210
+ )
211
+ })}
212
+ </div>
213
+
214
+ </section>
215
+ )
216
+ }
217
+
218
+ export default ProjectMagazineGallery
@@ -0,0 +1,28 @@
1
+ import React from 'react'
2
+ import ReactDOM from 'react-dom/client'
3
+ import App from './App'
4
+ import { portfolioConfig } from '../data'
5
+ import './styles.css'
6
+
7
+
8
+ const replaceProfileTokens = (value: string) => value
9
+ .replaceAll('{{name}}', portfolioConfig.profile.name)
10
+ .replaceAll('{{headline}}', portfolioConfig.profile.headline)
11
+ const pageTitle = replaceProfileTokens(portfolioConfig.seo.title)
12
+ const pageDescription = replaceProfileTokens(portfolioConfig.seo.description)
13
+ document.title = pageTitle
14
+ document.querySelector('meta[name="description"]')?.setAttribute('content', pageDescription)
15
+ document.querySelector('meta[property="og:title"]')?.setAttribute('content', pageTitle)
16
+ document.querySelector('meta[property="og:description"]')?.setAttribute('content', pageDescription)
17
+ document.querySelector('meta[name="twitter:title"]')?.setAttribute('content', pageTitle)
18
+ document.querySelector('meta[name="twitter:description"]')?.setAttribute('content', pageDescription)
19
+ if (portfolioConfig.seo.image) {
20
+ document.querySelector('meta[property="og:image"]')?.setAttribute('content', portfolioConfig.seo.image)
21
+ document.querySelector('meta[name="twitter:image"]')?.setAttribute('content', portfolioConfig.seo.image)
22
+ }
23
+
24
+ ReactDOM.createRoot(document.getElementById('root')!).render(
25
+ <React.StrictMode>
26
+ <App />
27
+ </React.StrictMode>,
28
+ )