skills.rest
Impertio-Studio
Impertio-StudioOFFICIAL
Explore all skills by this author →
WebsiteGitHub

frappe-ops-website-deploy

Deploy static HTML/CSS assets as ERPNext/Frappe Web Pages via REST API.

163|53|Updated Jan 14, 2026
Search Tags:#rest api#web pages#frappe#erpnext#page builder#html deploy#website settings
One-click install
npx skills add https://github.com/Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-ops-website-deploy-impertio-studio
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: frappe-ops-website-deploy
Source: https://github.com/Impertio-Studio/Frappe_Claude_Skill_Package/tree/main/skills/source/ops/frappe-ops-website-deploy
Command: npx skills add https://github.com/Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-ops-website-deploy-impertio-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill prevents broken ERPNext website deployments by guiding you through the correct Web Page/Page Builder workflow for rendering HTML (especially in Frappe v16), including the required API-driven setup for templates, page blocks, and Website Settings.

Core Features & Use Cases

  • Render-ready HTML deployment: Deploys static HTML/CSS websites as Web Pages using content_type: "Page Builder" with page_blocks.
  • Correct handling for Frappe v16: Ensures HTML is rendered via a custom "Section" Web Template using page_blocks, avoiding the main_section rendering trap.
  • Forum integration: Embeds ERPNext/Frappe Discussion Topic/Reply via the built-in "Discussions" Web Template on the same page.
  • Website Settings automation: Configures home_page, brand_html, head_html (including global CSS wrapper fixes), top_bar_items, and footer_items.
  • Deployment scripting: Provides a Python deployment script pattern that creates/updates the Web Template, rewrites links, extracts mockup body content, and pushes pages via REST.

Quick Start

Use the skill to deploy your HTML mockup by creating the Raw HTML Section template, then creating Web Pages with page_blocks and setting global layout fixes in Website Settings so the pages render correctly in Frappe v15/v16.

Frequently Asked Questions about frappe-ops-website-deploy

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

FAQPage Schema
How do I deploy static HTML to ERPNext as a Web Page?▼

To deploy static HTML to ERPNext, create a Web Page with content_type set to Page Builder and use page_blocks containing a custom Raw HTML Section Web Template to render your HTML and CSS assets correctly.

Why does my HTML render incorrectly on Frappe v16 Web Pages?▼

HTML renders incorrectly on Frappe v16 Web Pages when placed directly in main_section. You must use a custom Section Web Template within page_blocks and apply head_html wrapper CSS fixes to ensure proper rendering.

How do I embed a forum on an ERPNext Web Page?▼

You can embed a forum on an ERPNext Web Page by adding the built-in Discussions Web Template to your page_blocks, which renders Discussion Topic and Reply components directly on the page.

Can I configure ERPNext Website Settings via REST API?▼

Yes, you can configure ERPNext Website Settings via the REST API by pushing values for home_page, brand_html, head_html, top_bar_items, and footer_items to automate your global site layout and navigation.

Do I need to create a Web Template before deploying HTML to Frappe?▼

Yes, you must create a Raw HTML Section Web Template with a Text fieldtype before deploying HTML, because Frappe's Page Builder requires serialized web_template_values within page_blocks to render the content.

What is the best way to convert an HTML mockup into an ERPNext Web Page?▼

The best way to convert an HTML mockup into an ERPNext Web Page is using a Python deployment script that creates the Web Template, extracts body content, rewrites links, and pushes the page via the REST API.

Related Skills

Explore More Software Engineering Skills→
OpenAEC-FoundationOpenAEC-Foundation
163

frappe-website-deploy

Deploy ERPNext/Frappe websites via REST API with Page Builder.

Official
Advanced
OpenAEC-FoundationOpenAEC-Foundation
163

frappe-impl-website

Configure website routing, portal page rendering, and SEO metadata for Frappe apps.

Official
Advanced
joshua3403joshua3403

starter

Creates static websites with HTML, CSS, JavaScript starter templates.

Community
Basic
wineastwineast
1

html-template-extraction

Convert dual-language HTML files into templates with paired JSON content.

Community
Intermediate