skills/convert-to-vite/SKILL.md
Convert a standalone HTML game into a Vite project with proper module structure
npx skillsauth add puzzmo-com/oss convert-to-viteInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Convert this HTML game into a Vite-powered project.
Initialize a new package.json with:
"name" based on the game directory name"private": true"type": "module""scripts": "dev": "vite", "build": "vite build", "preview": "vite preview"Install dependencies:
vite as a devDependencyCreate vite.config.ts:
import { defineConfig } from "vite"
export default defineConfig({})
Extract inline <script> and <style> from index.html:
src/main.js (or src/main.ts)src/style.css<script type="module" src="/src/main.js"></script> and <link rel="stylesheet" href="/src/style.css">Move any standalone JS/CSS files into src/
Update all asset references to use relative paths that Vite can resolve
Verify if you need to edit the .gitignore to exclude dist/ and other build artifacts like node_modules etc
npx vite build completes without errorsnpx vite as it did beforeindex.html (except small config objects)tools
Configure the Puzzmo CLI for uploading game builds
tools
Edit the `integrations` block in puzzmo.json (leaderboards, notables, etc.) using live game context from the dev.puzzmo.com MCP
tools
Add integrations to puzzmo.json with leaderboard configuration using deeds
development
Set up Puzzmo platform fonts in a game using the SDK font utilities