From 315a98bf5ef30d934f890604cfb3d435342eca07 Mon Sep 17 00:00:00 2001 From: gitee-bot Date: Wed, 28 May 2025 16:29:11 +0000 Subject: [PATCH] Update README.md --- README.md | 91 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 91 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..7092894 --- /dev/null +++ b/README.md @@ -0,0 +1,91 @@ +Based on the code map you've provided, it appears to be a Nuxt.js/Vue.js application that allows users to create and customize code snippets with features like syntax highlighting (shiki), color themes, and export capabilities. The app includes a comprehensive set of UI components for editing, previewing, and sharing code snippets. + +Here's a well-structured README.md tailored to this project: + +--- + +# Code Snippet Customizer + +A beautiful, feature-rich code snippet customizer built with Vue.js and Nuxt.js. Customize your code snippets with themes, fonts, shadows, and more โ€“ then export them as images or share them online. + +![Screenshot](.github/screenshot.png) + +## ๐ŸŒŸ Features + +- **Syntax Highlighting**: Powered by Shiki for accurate and beautiful code rendering. +- **Theme Support**: Choose from multiple color themes or create your own custom theme. +- **Font Customization**: Use different fonts like JetBrains Mono or Nova. +- **Shadow Effects**: Add stylish shadows to your code snippets. +- **Export Options**: Export your snippets as PNG images. +- **Responsive UI**: Clean and modern interface with sidebar, toolbar, and resizable editor. +- **Persistent State**: Save your preferences and settings across sessions. +- **Social Sharing**: Easily share your snippets on Twitter or GitHub. + +## ๐Ÿ“ Project Structure + +The project is organized into several key directories: + +- `app/` - Main application files including Vue components, pages, and styles. +- `components/` - Reusable UI components like buttons, inputs, sliders, and icons. +- `lib/` - Utility functions and core logic for themes, colors, exports, and state management. +- `server/` - API routes and database logic using Drizzle ORM. +- `public/` - Static assets like fonts, icons, and images. +- `styles/` - CSS files for styling including color picker and theme-specific styles. +- `types.ts` - Shared TypeScript types and interfaces. + +## ๐Ÿ› ๏ธ Setup + +### Prerequisites + +- Node.js (v16+ recommended) +- PNPM (or npm/yarn if preferred) +- Git + +### Installation + +1. Clone the repository: + ```bash + git clone https://github.com/your-username/code-snippet-customizer.git + cd code-snippet-customizer + ``` + +2. Install dependencies: + ```bash + pnpm install + ``` + +3. Start the development server: + ```bash + pnpm dev + ``` + +4. Open your browser and visit: + ``` + http://localhost:3000 + ``` + +## ๐Ÿงช Development + +This project uses Nuxt 3 with Vue 3, TypeScript, and Tailwind CSS. You can use the following commands: + +- `pnpm dev` - Start the development server +- `pnpm build` - Build the application for production +- `pnpm start` - Start the production server after building +- `pnpm lint` - Lint the codebase +- `pnpm typecheck` - Run TypeScript type checking + +## ๐Ÿ“ฆ Deployment + +You can deploy this project on platforms like Vercel, Netlify, or any Node.js hosting service. Configuration files are included for Vercel deployment. + +## ๐Ÿค Contributing + +Contributions are welcome! Please read the [contributing guide](CONTRIBUTING.md) before submitting pull requests. + +## ๐Ÿ“„ License + +This project is licensed under the [MIT License](LICENSE). + +--- + +Let me know if you'd like me to extract any specific code examples or documentation from the files to enhance this README further. \ No newline at end of file -- Gitee