Skip to content

Chizukuo/ProfileCraft

Repository files navigation

ProfileCraft

中文 / 日本語 / 한국어

ProfileCraft is a browser-based profile card editor built with React + TypeScript. It is designed for creating "扩列条" style cards quickly, with rich text editing, flexible card layouts, and one-click export.

Live Demo

Features

  • Rich text editing (bold, italic, underline, strikethrough)
  • Dynamic cards and content blocks
  • Drag-and-resize layout based on react-grid-layout
  • Avatar upload and QR code update
  • Multi-language UI (zh-CN, en-US, ja-JP, ko-KR)
  • Built-in themes (Default, Cyberpunk)
  • Auto-save to localStorage
  • Export as standalone HTML or PNG

Tech Stack

  • React 19
  • TypeScript
  • Vite
  • Context API
  • react-grid-layout
  • html2canvas
  • qrcode.react
  • lucide-react

Quick Start

Requirements

  • Node.js 20+
  • npm 10+

Install

npm install

Start Development Server

npm run dev

Build Production Bundle

npm run build

Preview Build Output

npm run preview

Lint

npm run lint

Project Structure

src/
  components/      # App shell, cards, modals, UI components
  context/         # Profile / Locale / Theme contexts
  hooks/           # Reusable logic (layout, throttle, translation, etc.)
  config/          # Locale and theme registries
  utils/           # Export, i18n, theme and color utilities
  styles/          # Global and modular styles
  types/           # Shared TypeScript types
public/
  locales/         # Translation files
  themes/          # Theme CSS files
document/
  README.*.md      # Localized documentation

Data and Export Notes

  • User data is saved in browser localStorage.
  • Clearing browser storage will remove local drafts.
  • PNG export relies on html2canvas and may not perfectly render very complex CSS effects.
  • Exported HTML contains all required styles, and web font loading may require internet access.

License

MIT. See LICENSE.

About

A modern, web-based profile card (kuò liè tiáo) editor built with React and TypeScript. Create, customize, and export personalized social profile cards as high-res PNG or standalone HTML with live rich text editing and dynamic content blocks.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors