Jigsawify

Creates one-of-a-kind jigsaw puzzles using Autodesk's Forge platform.

Origins

This project originated from some work done to explore the use of laser cutters to create custom jigsaw puzzles. It became clear that some custom code - run inside AutoCAD - would help create a circular puzzle that was needed for a specific project. This code ended up being generalized and used an example of how AutoCAD I/O - now part of the Design Automation API in Autodesk's Forge platform - could run this code and make it available to web-sites and other web-services.

Setup

Prerequisites

1. Forge Account: Learn how to create a Forge Account, activate subscription and create an app at this tutorial.
2. Visual Studio: Either Community (Windows) or Code (Windows, MacOS)
3. JavaScript basic knowledge with jQuery
4. AutoCAD .NET basic knowledge with AutoCAD API
5. NET core 3.1 basic knowledge with .NET core 3.1

Run locally

Clone this project or download it. It's recommended to install GitHub desktop. To clone it via command line, use the following (Terminal on MacOSX/Linux, Git Shell on Windows):

git clone https://github.com/MadhukarMoogala/Jigsawify.git

Running Design Automation Client V3 and CrxApp

Step 1: Restoring and building crxapp

cd Jigsawify
cd management\crxapp
nuget install packages.config -OutputDirectory ..\packages
msbuild /t:Build /p:Configuration=Release;Platform=x64

Step2: Building design automation .NET core client application

This is step is necessary to test design automation application, this application creates an activity, uploads app bundles and runs a workitem, a .NET core console application to test and play.

cd management\clientv3
dotnet build

Step3: Running client application

cd management\clientv3
dotnet run

Step4: Running Jigsaw site application

Install NodeJS.

To run it, install the required packages, set the environment variables with your client ID & secret and finally start it. Via command line, navigate to the folder where this repository was cloned and use the following:

Mac OSX/Linux (Terminal) / Windows (use Node.js command line from Start menu)

set FORGE_CLIENT_ID=<YourClientId>
set FORGE_CLIENT_SECRET=<YourClientSecret>
npm install
npm start

Open the browser: http://localhost:3000.

Important: do not use npm start locally, this is intended for PRODUCTION only with HTTPS (SSL) secure cookies.

Deployment

To deploy this application to Heroku, the Callback URL for Forge must use your .herokuapp.com address. After clicking on the button below, at the Heroku Create New App page, set your Client ID, Secret and Callback URL for Forge.

Watch this video on how deploy samples to Heroku.

Supporting links

• Puzzling over laser cutters
• AutoCAD I/O and custom applications
• Finishing up our laser-cut jigsaw project
• Running custom .NET code in the cloud using AutoCAD I/O – Part 1
• Running custom .NET code in the cloud using AutoCAD I/O – Part 2
• Running custom .NET code in the cloud using AutoCAD I/O – Part 3
• Running custom .NET code in the cloud using AutoCAD I/O – Part 4
• Architecting my first AutoCAD I/O application
• Jigsawify.com: Creating custom jigsaw puzzles using AutoCAD I/O
• Jigsawify.com goes mobile-friendly

Written by

Kean Walmsley

Maintained by

Madhukar Moogala
@galakar http://forge.autodesk.com