Skip to main
Table of Contents

Synticore Builder Guide - Workflow

Purpose

This page provides practical, repeatable workflows for common day-to-day site-building tasks after your environment already works.

If you need compiler maintenance, migration internals, or low-level debugging flows, use the Synticore Developer Docs.

Before You Use This Page

Use this page when your environment already works and you want a repeatable operating routine.

For the shortest first-install and first-build path, use Synticore Builder Guide - Build Your First Site.

If you need the browser-side development model, dev panel, or BrowserSync context, use Synticore Builder Guide - Browser And Watch Tools.

If you want to scaffold a fresh project instead of working from the standalone example project repository, use Synticore Builder Guide - New Project.

If you want help choosing a starting point before scaffolding, use Synticore Builder Guide - Templates.

Daily Local Development Workflow

Use watch mode for active development:

npm run gulp watch -- --project "<project-dir>"

Typical loop:

  1. Edit source files under <project>/in/
  2. Let watch rebuild affected assets and pages
  3. Verify output in the browser
  4. Repeat

If behavior looks stale:

npm run gulp rebuild -- --project "<project-dir>"

For project-specific watch trigger rules, see the user-facing Synticore Builder Guide - Watch Triggers Guide.

Config-Change Workflow

Use this when config.json changes and you want the lowest-friction refresh path before escalating to a full rebuild.

When changing config.json:

npm run gulp sort_config -- --project "<project-dir>"
npm run gulp build_config -- --project "<project-dir>"
npm run gulp build -- --project "<project-dir>"

If needed, force a clean config refresh:

npm run gulp rebuild_config -- --project "<project-dir>"

Asset-Focused Workflow

Use these scoped rebuilds when only one asset family changed and you want faster feedback than a full rebuild.

Use scoped rebuild tasks to keep feedback fast:

npm run gulp rebuild_stylesheet -- --project "<project-dir>"
npm run gulp rebuild_javascript -- --project "<project-dir>"
npm run gulp rebuild_image -- --project "<project-dir>"

Other common targets:

  • rebuild_html
  • rebuild_font_icon
  • rebuild_favicon
  • rebuild_mirror

For font icon template override details, see Synticore Builder Guide - Font Icon Guide.

Release Packaging Workflow

Use this when you want a clean package artifact from known-good project output rather than an incremental watch/build state.

  1. Run a clean full build:
npm run gulp reset -- --project "<project-dir>"
npm run gulp build -- --project "<project-dir>"
  1. Produce package outputs:
npm run gulp package -- --project "<project-dir>"
  1. Collect artifacts from project _package/ or other configured package outputs.

Related

Explore More

Example Home Download Report Issue License