---
title: "Compiling Customer's Canvas from Source Code"
canonical: https://customerscanvas.com/docs/cc4/compiling-product-from-source-code.htm
archived: true
applies_to:
  - product: "Customer's Canvas On-Premises"
  - product: "Design Editor"
    versions: ["4.4.25", "4.x (may differ)"]
---

**You’re viewing outdated documentation.** [View the latest Customer’s Canvas On-Premises documentation](https://customerscanvas.com/docs/on-premises/).

# Compiling Customer's Canvas from Source Code

**Applies to:** Customer's Canvas On-Premises; Design Editor 4.4.25, 4.x (may differ) · **Archived documentation**
 
You can request the Customer's Canvas source code if you purchased the on-premises version. The Customer's Canvas source code is a Visual Studio solution designed for Visual Studio 2017.
 
## Prerequisites
  
1. Download and install [Microsoft Visual C++ 2017 Redistributable Package (x64)](https://aka.ms/vs/15/release/vc_redist.x64.exe).
2. Download and install [Microsoft .NET Framework 4.6.2](https://www.microsoft.com/net/download/thank-you/net462) or higher.
3. Download [Visual Studio 2017↗](https://docs.microsoft.com/en-us/visualstudio/releasenotes/vs2017-relnotes) and install it with the **ASP.NET and web development** workload enabled. 
    ![ASP.NET and web development workload.](https://customerscanvas.com/docs/cc4/images/VSWorkloads.png)
4. Download and install [TypeScript 2.4.0 for Visual Studio↗](http://download.microsoft.com/download/6/D/8/6D8381B0-03C1-4BD2-AE65-30FF0A4C62DA/2.4.0-TS-release-dev14update3-20170608.3/TypeScript_Dev14Full.exe). Note that you may obtain compilation errors if you install a different version of TypeScript.
5. Download and install [node.js 8.11.3 (x64)](https://nodejs.org/en/download/) or higher.
 
## Compiling the Application
  
To build the solution:
 
1. Extract the `CustomersCanvasSrc.zip` archive to your file system.
2. Open `\src\CustomersCanvas.sln` in Visual Studio.
3. Navigate to **Tools** > **Options** > **Projects and Solutions** > **Web Package Management** > **External Web Tools** and move `$(PATH)` above the `.\node_modules\.bin` internal path. 
    ![Set up external paths.](https://customerscanvas.com/docs/cc4/images/ExternalPaths.png)
4. Install npm packages: in **Solution Explorer**, right-click `package.json` in the **SimplePolygraphy** project and click **Restore Packages**. 
    ![Restore npm packages.](https://customerscanvas.com/docs/cc4/images/RestorePackages.png)
5. Next, select **Release** on the **Solution Configurations** menu and **Any CPU** in **Solution Platforms**. 
    ![The list of available configurations.](https://customerscanvas.com/docs/cc4/images/VSConfigurationManager.png)
6. Build the solution: press **Ctrl**+**Shift**+**B** or click **Build** > **Build Solution** on the menu.
7. Copy your license file (`Aurigma.GraphicsMill.lic`) to the `\src\SimplePolygraphy\bin\` folder or use an alternative way of [registering your license keys](https://customerscanvas.com/docs/cc4/registering-production-license-keys.htm.md).
8. Include the license file in the project; this way the license file will be sent to the server when the project is published. To include the file in the project, perform the following steps:
    1. Click the **Show All Files** icon in the **Solution Explorer**. 
        ![Show All Files in Solution Explorer.](https://customerscanvas.com/docs/cc4/images/IncludeLic01.png)
    2. Open the `\bin\` folder, find `Aurigma.GraphicsMill.lic`, right-click it, and then click **Include In Project**. 
        ![Including Aurigma.GraphicsMill.lic to the project.](https://customerscanvas.com/docs/cc4/images/IncludeLic03.png)
9. Set **SimplePolygraphy** as a startup project: right-click SimplePolygraphy in **Solution Explorer** and click **Set as StartUp Project**. 
    ![Setting as StartUp Project.](https://customerscanvas.com/docs/cc4/images/StartUpProject.png)
10. Start the project: press **Ctrl**+**F5** or click **Debug** > **Start Without Debugging** on the menu. In your browser, you should see a page containing an image carousel allowing you to select a product and the web-to-print designer.

If you run Visual Studio as an administrator, you can deploy this application: right-click **SimplePolygraphy** in **Solution Explorer** and click **Publish**. You can find more information on the deployment in the [Deploying Customer's Canvas to Windows Servers](https://customerscanvas.com/docs/cc4/deploying-application-to-windows-server-and-azure.htm.md) topic.
 
If you face a compilation problem, refer to the [Troubleshooting](https://customerscanvas.com/docs/cc4/troubleshooting.htm.md) topic for a solution.
 
## See Also
  
### Manual
 
- [Deploying Customer's Canvas to Windows Servers](https://customerscanvas.com/docs/cc4/deploying-application-to-windows-server-and-azure.htm.md)
- [Troubleshooting](https://customerscanvas.com/docs/cc4/troubleshooting.htm.md)

### Other
 
- [Microsoft Visual C++ downloads↗](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads)
- [TypeScript↗](http://download.microsoft.com/download/6/D/8/6D8381B0-03C1-4BD2-AE65-30FF0A4C62DA/2.4.0-TS-release-dev14update3-20170608.3/TypeScript_Dev14Full.exe)
- [node.js↗](https://nodejs.org/en/download/)