==================================================================
  GridCraft for Photoshop  —  Layout & typographic grids
  Installation Guide  (v1.0)
==================================================================

GridCraft builds 30+ classic layout and typographic grid systems
fitted to your canvas, output as native Photoshop GUIDES.

This download includes TWO editions — pick the one that matches your
Photoshop. You only need ONE.

  GridCraft.ccx        <- MODERN edition (UXP plugin). RECOMMENDED.
                          Easiest install: just double-click it.
  GridCraft/  (folder) <- LEGACY edition (CEP extension) for older
                          Photoshop, or if the .ccx won't install.

  ┌────────────────────────────────────────────────────────────┐
  │ Photoshop 2021 (v22) or newer ........ use METHOD 1 (.ccx)  │
  │ Photoshop 2019–2020, or .ccx fails ... use METHOD 2 (folder)│
  └────────────────────────────────────────────────────────────┘


==================================================================
  METHOD 1 — GridCraft.ccx  (recommended, no extra tools)
==================================================================
This is the easy one. No "debug mode", no Terminal, no ZXP installer.
You just need the Adobe Creative Cloud desktop app (which you already
have if you installed Photoshop).

  1. Quit Photoshop.
  2. Double-click  GridCraft.ccx
     The Creative Cloud desktop app opens and installs the plugin.
     (If macOS/Windows asks what to open it with, choose
      "Creative Cloud" / "Adobe Creative Cloud".)
  3. Open Photoshop.
  4. Open the panel from:   Plugins  >  GridCraft  >  GridCraft
     Dock it wherever you like.

That's it — it stays installed permanently. To remove it later, open
the Creative Cloud app > Stock & Marketplace > Manage plugins.


==================================================================
  METHOD 2 — GridCraft folder  (legacy CEP, older Photoshop)
==================================================================
Use this only if METHOD 1 didn't work or you're on an older Photoshop.

------------------------------------------------------------------
STEP 1 — COPY THE FOLDER INTO THE CEP EXTENSIONS DIRECTORY
------------------------------------------------------------------
Move the "GridCraft" folder from this download into:

  macOS:
    ~/Library/Application Support/Adobe/CEP/extensions/
    (In Finder: Go > Go to Folder…  and paste:
     ~/Library/Application Support/Adobe/CEP/extensions )

  Windows:
    C:\Users\<YourName>\AppData\Roaming\Adobe\CEP\extensions\

If the "CEP" or "extensions" folders don't exist, create them.
Final path should look like:
  …/Adobe/CEP/extensions/GridCraft/CSXS/manifest.xml

NOTE: If you also use the Illustrator edition of GridCraft, keep the
two in separate folders (e.g. name this one "GridCraftPS"). They have
different IDs and won't conflict.


------------------------------------------------------------------
STEP 2 — ENABLE UNSIGNED EXTENSIONS (one-time)  ← DON'T SKIP THIS
------------------------------------------------------------------
The folder edition is unsigned, so Photoshop shows a BLANK panel
until you turn on "debug mode" once. This is the #1 cause of a
white/empty panel.

  macOS — open Terminal, paste each line, press Return:
    defaults write com.adobe.CSXS.12 PlayerDebugMode 1
    defaults write com.adobe.CSXS.11 PlayerDebugMode 1
    defaults write com.adobe.CSXS.10 PlayerDebugMode 1
    defaults write com.adobe.CSXS.9  PlayerDebugMode 1

  Windows — press Win+R, type  regedit  , Enter. For each of:
    HKEY_CURRENT_USER\Software\Adobe\CSXS.12  (also .11, .10, .9)
  create/edit a String value named  PlayerDebugMode  set to  1.

(A ZXP installer such as ZXP/UXP Installer or Anastasiy's Extension
 Manager can install the folder edition for you and skips this step —
 but it's optional, and the .ccx in METHOD 1 is simpler.)


------------------------------------------------------------------
STEP 3 — RESTART PHOTOSHOP & OPEN THE PANEL
------------------------------------------------------------------
1. Fully quit Photoshop, then reopen it.
2. Go to:   Window  >  Extensions (legacy)  >  GridCraft
   (In some versions it's simply Window > Extensions.)
3. Dock the panel wherever you like.


------------------------------------------------------------------
HOW TO USE  (both editions)
------------------------------------------------------------------
1. Open or create a document.
2. Click "↻ Measure" to confirm the canvas size in pixels.
3. Pick a grid (columns, modular, baseline, golden section,
   Fibonacci, rule of thirds, 8-point, 12-column, material, bento,
   isometric, Van de Graaf, and more).
4. Set the parameters, choose a color & stroke width.
5. Click "Build Grid".

The panel scrolls — if your window is short, scroll inside the panel
or drag its edge to see every control and the Build button.

To remove a grid: View > Clear Guides (for guides), and/or delete
the "GridCraft — …" layer. A single Undo (Cmd/Ctrl+Z) also works.


------------------------------------------------------------------
TROUBLESHOOTING
------------------------------------------------------------------
• (.ccx) Double-clicking does nothing / no Creative Cloud prompt:
    – Make sure the Creative Cloud desktop app is installed and
      signed in, then double-click GridCraft.ccx again. Or fall
      back to METHOD 2 (the folder edition).

• (folder) Panel is BLANK / white, or "GridCraft" isn't in
  Window > Extensions:
    – Complete STEP 2 (debug mode) and FULLY restart Photoshop.
      Skipping debug mode is the usual cause of a blank panel.
    – Re-check the folder path from STEP 1 and that the whole
      GridCraft folder (js/, jsx/, CSXS/, icons/) was copied.

• Can't see all the controls / the Build button:
    – The panel scrolls; scroll down inside it, or drag the panel's
      edge to make it taller.

• Guides didn't appear:
    – Make sure View > Show > Guides is on (Cmd/Ctrl+;).


------------------------------------------------------------------
UNINSTALL
------------------------------------------------------------------
• .ccx edition:   Creative Cloud app > Manage plugins > remove.
• folder edition: delete the "GridCraft" folder from CEP/extensions.


------------------------------------------------------------------
GridCraft for Photoshop v1.0
==================================================================
