html-to-next-page

Convert static HTML mockups into reusable Next.js pages or components.

Updated Dec 13, 2025
One-click install
npx skills add https://github.com/hoangkhoanguyen/portfolio-eros --skill html-to-next-page
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: html-to-next-page
Source: https://github.com/hoangkhoanguyen/portfolio-eros/tree/main/.cursor/skills/html-to-next-page
Command: npx skills add https://github.com/hoangkhoanguyen/portfolio-eros --skill html-to-next-page

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert static HTML mockups into reusable Next.js pages or components, preserving structure and responsive classes while aligning with the project's styling tokens.

Core Features & Use Cases

  • Convert full pages or individual sections into Next.js app routes or component modules, reusing existing layout and typography.
  • Map mock tokens (colors, spacing) to project theme tokens and ensure dark mode compatibility.
  • Use case: port a multi-section HTML export into a single page or split into components for reuse across routes.

Quick Start

Port a provided HTML mockup into a Next.js page or component by preserving structure and tokens.

Frequently Asked Questions about html-to-next-page

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert static HTML mockups into Next.js components?

You can convert static HTML mockups into Next.js components by porting HTML exports into App Router routes or component modules. This preserves the original structure and responsive classes while aligning styling tokens with the project theme.

Can I map mock HTML color and spacing tokens to existing Tailwind theme tokens?

Yes, you can map mock HTML color and spacing tokens to existing Tailwind theme tokens during the porting process. This ensures the converted Next.js pages align with the project's styling and maintain dark mode compatibility.

What is the best way to port Storybook-style HTML into a Next.js App Router structure?

The best way to port Storybook-style HTML into a Next.js App Router structure is to apply porting directly to the HTML exports. This aligns the static markup with app routes, preserving theme tokens and internal routing while removing external scripts.

Does converting HTML to Next.js pages remove unnecessary fonts and external scripts?

Yes, converting HTML to Next.js pages removes unnecessary fonts and external scripts. This ensures the ported static mockups align cleanly with the App Router structure without carrying over unused external dependencies.

Can I split a multi-section HTML export into separate reusable Next.js routes?

Yes, you can split a multi-section HTML export into separate reusable Next.js routes. The porting process allows you to convert full pages into individual component modules for reuse across multiple application routes.

Why does my ported HTML mockup lose dark mode compatibility in Next.js?

Ported HTML mockups lose dark mode compatibility in Next.js when mock tokens are not properly mapped to project theme tokens. Correctly mapping these styling tokens during conversion ensures dark mode styles are preserved.