create-near-app 4.0.0-beta.3.0 → 4.1.0

package/README.md

@@ -17,6 +17,8 @@ To create a new NEAR project run this and follow interactive prompts:
 
     npx create-near-app
 
+> If you've previously installed `create-near-app` globally via `npm install -g create-near-app`, please uninstall the package using `npm uninstall -g create-near-app` to ensure that `npx` always uses the latest version.
+
 Follow the instructions in the README.md in the project you just created! 🚀
 
 You can create contracts written in:

package/dist/app.js

@@ -35,11 +35,8 @@ const show = __importStar(require("./messages"));
     if (promptResult === null) {
         return;
     }
-    const { config: { projectName, contract, frontend, tests, install }, projectPath, isFromPrompts, } = promptResult;
+    const { config: { projectName, contract, frontend, tests, install, }, projectPath, } = promptResult;
     show.creatingApp();
-    if (contract === 'assemblyscript') {
-        show.assemblyscriptWarning();
-    }
     let createSuccess;
     try {
         createSuccess = await (0, make_1.createProject)({
@@ -56,21 +53,15 @@ const show = __importStar(require("./messages"));
         console.error(e);
         createSuccess = false;
     }
+    if (install) {
+        await (0, make_1.runDepsInstall)(projectPath);
+    }
     if (createSuccess) {
-        show.setupSuccess(projectPath, contract, frontend);
+        show.setupSuccess(projectName, contract, frontend, install);
     }
     else {
         show.setupFailed();
         return;
     }
-    if (install) {
-        await (0, make_1.runDepsInstall)(projectPath);
-    }
-    else if (isFromPrompts) {
-        const { depsInstall } = await (0, user_input_1.showDepsInstallPrompt)();
-        if (depsInstall) {
-            await (0, make_1.runDepsInstall)(projectPath);
-        }
-    }
 })();
 //# sourceMappingURL=app.js.map

package/dist/make.js

@@ -47,34 +47,35 @@ async function createFiles({ contract, frontend, tests, projectPath, verbose, ro
     const skip = ['.cache', 'dist', 'out', 'node_modules'];
     // copy frontend
     if (frontend !== 'none') {
-        const sourceTemplateDir = `${rootDir}/frontend/${frontend}`;
-        await copyDir(sourceTemplateDir, projectPath, { verbose, skip: skip.map(f => path_1.default.join(sourceTemplateDir, f)) });
+        const sourceFrontendDir = path_1.default.resolve(`${rootDir}/frontend/${frontend}`);
+        const sourceSharedFrontendDir = path_1.default.resolve(`${rootDir}/frontend/shared`);
+        const targetFrontendDir = path_1.default.resolve(`${projectPath}/frontend`);
+        fs_1.default.mkdirSync(targetFrontendDir, { recursive: true });
+        await copyDir(sourceFrontendDir, targetFrontendDir, { verbose, skip: skip.map(f => path_1.default.join(sourceFrontendDir, f)) });
+        await copyDir(sourceSharedFrontendDir, targetFrontendDir, { verbose, skip: skip.map(f => path_1.default.join(sourceSharedFrontendDir, f)) });
     }
     // shared files
-    const sourceSharedDir = `${rootDir}/shared`;
+    const sourceSharedDir = path_1.default.resolve(rootDir, 'shared');
     await copyDir(sourceSharedDir, projectPath, { verbose, skip: skip.map(f => path_1.default.join(sourceSharedDir, f)) });
     // copy contract files
-    const contractSourceDir = `${rootDir}/contracts/${contract}`;
-    await copyDir(contractSourceDir, `${projectPath}/contract`, {
+    const sourceContractDir = path_1.default.resolve(rootDir, 'contracts', contract);
+    const targetContractDir = path_1.default.resolve(projectPath, 'contract');
+    fs_1.default.mkdirSync(targetContractDir, { recursive: true });
+    await copyDir(sourceContractDir, targetContractDir, {
         verbose,
-        skip: skip.map(f => path_1.default.join(contractSourceDir, f))
+        skip: skip.map(f => path_1.default.join(sourceContractDir, f))
     });
+    // tests dir
+    const targetTestDir = path_1.default.resolve(projectPath, 'integration-tests');
+    fs_1.default.mkdirSync(targetTestDir, { recursive: true });
     // copy tests - shared files
-    let sourceTestSharedDir = path_1.default.resolve(`${rootDir}/integration-tests/shared/${tests}-tests`);
-    await copyDir(sourceTestSharedDir, `${projectPath}/integration-tests/`, {
+    const sourceTestSharedDir = path_1.default.resolve(`${rootDir}/integration-tests/${tests}-tests`);
+    await copyDir(sourceTestSharedDir, targetTestDir, {
         verbose,
         skip: skip.map(f => path_1.default.join(sourceTestSharedDir, f))
     });
-    // copy tests - overrides files
-    let sourceTestOverridesDir = path_1.default.resolve(`${rootDir}/integration-tests/overrides/${contract}-contract/${tests}-tests`);
-    if (fs_1.default.existsSync(sourceTestOverridesDir)) {
-        await copyDir(sourceTestOverridesDir, `${projectPath}/integration-tests/`, {
-            verbose,
-            skip: skip.map(f => path_1.default.join(sourceTestOverridesDir, f))
-        });
-    }
     // add .gitignore
-    await (0, exports.renameFile)(`${projectPath}/near.gitignore`, `${projectPath}/.gitignore`);
+    await (0, exports.renameFile)(`${projectPath}/template.gitignore`, `${projectPath}/.gitignore`);
 }
 exports.createFiles = createFiles;
 const renameFile = async function (oldPath, newPath) {
@@ -119,7 +120,7 @@ function copyDir(source, dest, { skip, verbose }) {
 exports.copyDir = copyDir;
 async function runDepsInstall(projectPath) {
     show.depsInstall();
-    const npmCommandArgs = ['run', 'deps-install'];
+    const npmCommandArgs = ['install'];
     await new Promise((resolve, reject) => (0, cross_spawn_1.default)('npm', npmCommandArgs, {
         cwd: projectPath,
         stdio: 'inherit',

package/dist/messages.js

@@ -3,19 +3,22 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.depsInstallError = exports.depsInstall = exports.creatingApp = exports.directoryExists = exports.assemblyscriptWarning = exports.windowsWarning = exports.unsupportedNodeVersion = exports.argsError = exports.setupSuccess = exports.successFrontendToText = exports.successContractToText = exports.setupFailed = exports.welcome = exports.log = void 0;
+exports.depsInstallError = exports.depsInstall = exports.creatingApp = exports.directoryExists = exports.windowsWarning = exports.unsupportedNodeVersion = exports.argsError = exports.setupSuccess = exports.successFrontendToText = exports.successContractToText = exports.setupFailed = exports.welcome = exports.show = void 0;
 const chalk_1 = __importDefault(require("chalk"));
 const tracking_1 = require("./tracking");
-const log = (...args) => console.log(...args);
-exports.log = log;
-const welcome = () => (0, exports.log)((0, chalk_1.default) `{blue ======================================================}
+if (process.env.NEAR_NO_COLOR) {
+    chalk_1.default.level = 0;
+}
+const show = (...args) => console.log(...args);
+exports.show = show;
+const welcome = () => (0, exports.show)((0, chalk_1.default) `{blue ======================================================}
 👋 {bold {green Welcome to NEAR!}} Learn more: https://docs.near.org/
 🔧 Let's get your dApp ready.
 {blue ======================================================}
 (${tracking_1.trackingMessage})
 `);
 exports.welcome = welcome;
-const setupFailed = () => (0, exports.log)((0, chalk_1.default) `{bold {red ==========================================}}
+const setupFailed = () => (0, exports.show)((0, chalk_1.default) `{bold {red ==========================================}}
 {red ⛔️ There was a problem during NEAR project setup}.
 Please refer to https://github.com/near/create-near-app README to troubleshoot.
 Notice: some platforms aren't supported (yet).
@@ -25,32 +28,42 @@ const successContractToText = (contract) => (0, chalk_1.default) `with a smart c
 exports.successContractToText = successContractToText;
 const successFrontendToText = (frontend) => frontend === 'none' ? '' : (0, chalk_1.default) ` and a frontend template${frontend === 'react' ? (0, chalk_1.default) `{bold  in React.js}` : ''}`;
 exports.successFrontendToText = successFrontendToText;
-const setupSuccess = (projectName, contract, frontend) => (0, exports.log)((0, chalk_1.default) `
+const setupSuccess = (projectName, contract, frontend, install) => (0, exports.show)((0, chalk_1.default) `
+{green ======================================================}
 ✅  Success! Created '${projectName}'
    ${(0, exports.successContractToText)(contract)}${(0, exports.successFrontendToText)(frontend)}.
-🧠 See {bold {green README.md}} to get started.
-${contract === 'rust' ? (0, chalk_1.default) `🦀 If you are new to Rust please visit {bold {green https://www.rust-lang.org }}` : ''}
-Happy Hacking! 👍
-{blue ======================================================}`);
+${contract === 'rust' ? (0, chalk_1.default) `🦀 If you are new to Rust please visit {bold {green https://www.rust-lang.org }}\n` : ''}
+  {bold {bgYellow {black Your next steps}}}:
+   - {inverse Navigate to your project}:
+         {blue cd {bold ${projectName}}}
+   ${!install ? (0, chalk_1.default) `- {inverse Install all dependencies}
+         {blue npm {bold install}}` : 'Then:'}
+   - {inverse Test your contract} in NEAR SandBox:
+         {blue npm {bold test}}
+   - {inverse Deploy your contract} to NEAR TestNet with a temporary dev account:
+         {blue npm {bold run deploy}}
+   ${frontend !== 'none' ? (0, chalk_1.default) `- {inverse Start your frontend}:
+         {blue npm {bold start}}\n` : ''}
+🧠 Read {bold {greenBright README.md}} to explore further.`);
 exports.setupSuccess = setupSuccess;
-const argsError = () => (0, exports.log)((0, chalk_1.default) `{red Arguments error}
+const argsError = () => (0, exports.show)((0, chalk_1.default) `{red Arguments error}
 Run {blue npx create-near-app} without arguments, or use:
 npx create-near-app <projectName> --contract rust|js|assemblyscript --frontend react|vanilla|none --tests js|rust`);
 exports.argsError = argsError;
-const unsupportedNodeVersion = (supported) => (0, exports.log)((0, chalk_1.default) `{red We support node.js version ${supported} or later}`);
+const unsupportedNodeVersion = (supported) => (0, exports.show)((0, chalk_1.default) `{red We support node.js version ${supported} or later}`);
 exports.unsupportedNodeVersion = unsupportedNodeVersion;
-const windowsWarning = () => (0, exports.log)((0, chalk_1.default) `👉 Notice: On Windows we recommend using WSL.`);
+const windowsWarning = () => (0, exports.show)((0, chalk_1.default) `{bgYellow {black Notice: On Win32 please use WSL (Windows Subsystem for Linux).}}
+https://docs.microsoft.com/en-us/windows/wsl/install
+Exiting now.`);
 exports.windowsWarning = windowsWarning;
-const assemblyscriptWarning = () => (0, exports.log)((0, chalk_1.default) `👉 Notice: AssemblyScript is not supported on all platforms.`);
-exports.assemblyscriptWarning = assemblyscriptWarning;
-const directoryExists = (dirName) => (0, exports.log)((0, chalk_1.default) `{red This directory already exists! ${dirName}}`);
+const directoryExists = (dirName) => (0, exports.show)((0, chalk_1.default) `{red This directory already exists! ${dirName}}`);
 exports.directoryExists = directoryExists;
-const creatingApp = () => (0, exports.log)((0, chalk_1.default) `\n...creating a new NEAR app...`);
+const creatingApp = () => (0, exports.show)((0, chalk_1.default) `\nCreating a new {bold NEAR dApp}`);
 exports.creatingApp = creatingApp;
-const depsInstall = () => (0, exports.log)((0, chalk_1.default) `
-{green Installing dependencies in a few folders, this might take a while...}
+const depsInstall = () => (0, exports.show)((0, chalk_1.default) `
+{green Installing dependencies in a few folders, this might take a while.}
 `);
 exports.depsInstall = depsInstall;
-const depsInstallError = () => (0, exports.log)(chalk_1.default.red('Error installing NEAR project dependencies'));
+const depsInstallError = () => (0, exports.show)(chalk_1.default.red('Error installing NEAR project dependencies'));
 exports.depsInstallError = depsInstallError;
 //# sourceMappingURL=messages.js.map

package/dist/package-json.js

@@ -51,10 +51,8 @@ const buildContractScript = (contract) => {
             };
         case 'rust':
             return {
-                'build:contract': 'cd contract && rustup target add wasm32-unknown-unknown && cargo build --all --target wasm32-unknown-unknown --release',
+                'build:contract': 'cd contract && ./build.sh',
             };
-        default:
-            return {};
     }
 };
 const deployScript = (contract) => {
@@ -66,10 +64,8 @@ const deployScript = (contract) => {
             };
         case 'rust':
             return {
-                'deploy': 'npm run build:contract && cd contract && near dev-deploy --wasmFile ./target/wasm32-unknown-unknown/release/hello_near.wasm',
+                'deploy': 'cd contract && ./deploy.sh',
             };
-        default:
-            return {};
     }
 };
 const unitTestScripts = (contract) => {
@@ -79,8 +75,6 @@ const unitTestScripts = (contract) => {
             return { 'test:unit': 'cd contract && npm test' };
         case 'rust':
             return { 'test:unit': 'cd contract && cargo test' };
-        default:
-            return {};
     }
 };
 const integrationTestScripts = (contract, tests) => {
@@ -118,45 +112,59 @@ const integrationTestScripts = (contract, tests) => {
                     'test:integration': 'npm run build:contract && cd integration-tests && cargo run --example integration-tests "../contract/target/wasm32-unknown-unknown/release/hello_near.wasm"',
                 };
             }
-        default:
-            return {};
     }
 };
 const npmInstallScript = (contract, hasFrontend, tests) => {
     switch (contract) {
         case 'assemblyscript':
+            if (hasFrontend) {
+                if (tests === 'js') {
+                    return { 'postinstall': 'cd contract && npm install --ignore-scripts && cd ../integration-tests && npm install && cd ../frontend && npm install && cd ..' };
+                }
+                else {
+                    return { 'postinstall': 'cd contract && npm install --ignore-scripts && cd ../frontend && npm install && cd ..' };
+                }
+            }
+            else {
+                if (tests === 'js') {
+                    return { 'postinstall': 'cd contract && npm install --ignore-scripts && cd ../integration-tests && npm install && cd ..' };
+                }
+                else {
+                    return { 'postinstall': 'cd contract && npm install --ignore-scripts && cd ..' };
+                }
+            }
         case 'js':
             if (hasFrontend) {
                 if (tests === 'js') {
-                    return { 'deps-install': 'npm install && cd contract && npm install && cd ../integration-tests && npm install && cd ../frontend && npm install && cd ..' };
+                    return { 'postinstall': 'cd contract && npm install && cd ../integration-tests && npm install && cd ../frontend && npm install && cd ..' };
                 }
                 else {
-                    return { 'deps-install': 'npm install && cd contract && npm install && cd ../frontend && npm install && cd ..' };
+                    return { 'postinstall': 'cd contract && npm install && cd ../frontend && npm install && cd ..' };
                 }
             }
             else {
                 if (tests === 'js') {
-                    return { 'deps-install': 'npm install && cd contract && npm install && cd ../integration-tests && npm install && cd ..' };
+                    return { 'postinstall': 'cd contract && npm install && cd ../integration-tests && npm install && cd ..' };
                 }
                 else {
-                    return { 'deps-install': 'npm install && cd contract && npm install && cd ..' };
+                    return { 'postinstall': 'cd contract && npm install && cd ..' };
                 }
             }
         case 'rust':
             if (hasFrontend) {
                 if (tests === 'js') {
-                    return { 'deps-install': 'npm install && cd frontend && npm install && cd ../integration-tests && npm install && cd ..' };
+                    return { 'postinstall': 'cd frontend && npm install && cd ../integration-tests && npm install && cd ..' };
                 }
                 else {
-                    return { 'deps-install': 'npm install && cd frontend && npm install && cd ..' };
+                    return { 'postinstall': 'cd frontend && npm install && cd ..' };
                 }
             }
             else {
                 if (tests === 'js') {
-                    return { 'deps-install': 'npm install && cd ./integration-tests && npm install && cd ..' };
+                    return { 'postinstall': 'cd ./integration-tests && npm install && cd ..' };
                 }
                 else {
-                    return { 'deps-install': 'npm install' };
+                    return {};
                 }
             }
     }

package/dist/tracking.js

@@ -9,10 +9,10 @@ const mixpanel_1 = __importDefault(require("mixpanel"));
 const MIXPANEL_TOKEN = 'df164f13212cbb0dfdae991da60e87f2';
 const tracker = mixpanel_1.default.init(MIXPANEL_TOKEN);
 exports.trackingMessage = (0, chalk_1.default) `NEAR collects anonymous information on the commands used. No personal information that could identify you is shared`;
-// TODO: track different failures & deps-install usage
+// TODO: track different failures & install usage
 const trackUsage = async (frontend, contract) => {
     // prevents logging from CI
-    if (process.env.IS_GITHUB_ACTION) {
+    if (process.env.NEAR_ENV === 'ci' || process.env.NODE_ENV === 'ci') {
         console.log('Mixpanel logging is skipped in CI env');
         return;
     }

package/dist/types.js

@@ -1,3 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.TESTING_FRAMEWORKS = exports.FRONTENDS = exports.CONTRACTS = void 0;
+exports.CONTRACTS = ['assemblyscript', 'js', 'rust'];
+exports.FRONTENDS = ['react', 'vanilla', 'none'];
+exports.TESTING_FRAMEWORKS = ['rust', 'js'];
 //# sourceMappingURL=types.js.map

package/dist/user-input.js

@@ -26,7 +26,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.projectPath = exports.promptAndGetConfig = exports.userAnswersAreValid = exports.showDepsInstallPrompt = exports.showProjectNamePrompt = exports.getUserAnswers = exports.validateUserArgs = exports.getUserArgs = void 0;
+exports.projectPath = exports.promptAndGetConfig = exports.userAnswersAreValid = exports.showProjectNamePrompt = exports.getUserAnswers = exports.validateUserArgs = exports.getUserArgs = void 0;
+const types_1 = require("./types");
 const chalk_1 = __importDefault(require("chalk"));
 const prompts_1 = __importDefault(require("prompts"));
 const commander_1 = require("commander");
@@ -59,9 +60,9 @@ function validateUserArgs(args) {
     const hasAllArgs = hasAllOptions && hasProjectName;
     const hasNoArgs = !hasPartialOptions && !hasProjectName;
     const optionsAreValid = hasAllOptions
-        && ['react', 'vanilla', 'none'].includes(frontend)
-        && ['js', 'rust', 'assemblyscript'].includes(contract)
-        && ['js', 'rust'].includes(tests);
+        && types_1.FRONTENDS.includes(frontend)
+        && types_1.CONTRACTS.includes(contract)
+        && types_1.TESTING_FRAMEWORKS.includes(tests);
     if (hasNoArgs) {
         return 'none';
     }
@@ -73,35 +74,38 @@ function validateUserArgs(args) {
     }
 }
 exports.validateUserArgs = validateUserArgs;
+const contractChoices = [
+    { title: 'TypeScript', value: 'js' },
+    { title: 'Rust', value: 'rust' },
+    { title: 'AssemblyScript', value: 'assemblyscript' },
+];
+const testsChoices = [
+    { title: 'Rust Sandbox Tests', value: 'rust' },
+    { title: 'TypeScript Sandbox Tests', value: 'js' },
+];
+const frontendChoices = [
+    { title: 'React.js', value: 'react' },
+    { title: 'Vanilla JavaScript', value: 'vanilla' },
+    { title: 'No frontend', value: 'none' },
+];
 const userPrompts = [
     {
         type: 'select',
         name: 'contract',
         message: 'Select your smart-contract language',
-        choices: [
-            { title: 'JavaScript', value: 'js' },
-            { title: 'Rust', value: 'rust' },
-            { title: 'AssemblyScript', value: 'assemblyscript' },
-        ]
+        choices: contractChoices,
     },
     {
         type: prev => prev === 'rust' ? 'select' : null,
         name: 'tests',
         message: 'Select language for Sandbox Test',
-        choices: [
-            { title: 'Rust Sandbox Tests', value: 'rust' },
-            { title: 'JavaScript Sandbox Tests', value: 'js' },
-        ]
+        choices: testsChoices,
     },
     {
         type: 'select',
         name: 'frontend',
         message: 'Select a template for your frontend',
-        choices: [
-            { title: 'React.js', value: 'react' },
-            { title: 'Vanilla JavaScript', value: 'vanilla' },
-            { title: 'No frontend', value: 'none' },
-        ]
+        choices: frontendChoices,
     },
     {
         type: 'text',
@@ -109,10 +113,15 @@ const userPrompts = [
         message: 'Name your project (this will create a directory with that name)',
         initial: 'hello-near',
     },
+    {
+        type: 'confirm',
+        name: 'install',
+        message: (0, chalk_1.default) `Run {bold {blue 'npm install'}} now?`,
+        initial: true,
+    },
 ];
 async function getUserAnswers() {
-    const [contract, frontend, tests, projectName] = userPrompts;
-    const answers = await (0, prompts_1.default)([contract, frontend, tests, projectName]);
+    const answers = await (0, prompts_1.default)(userPrompts);
     if (!answers.tests) {
         answers.tests = answers.contract !== 'rust' ? 'js' : 'rust';
     }
@@ -125,22 +134,6 @@ async function showProjectNamePrompt() {
     return answers;
 }
 exports.showProjectNamePrompt = showProjectNamePrompt;
-async function showDepsInstallPrompt() {
-    const questions = [
-        {
-            type: 'toggle',
-            name: 'depsInstall',
-            // message: chalk`One last thing:\n  There are few package.json files with dependencies. We can run {bold {blue 'yarn install'}} for you.\n  Run {bold {blue 'yarn install'}} now? (To do it yourself: {blue 'yarn run deps-install'}).\n  \n`,
-            message: (0, chalk_1.default) `Run {bold {blue 'npm install'}} now in all folders? (To do it yourself: {blue 'npm run deps-install'}).\n`,
-            initial: true,
-            active: 'yes',
-            inactive: 'no'
-        },
-    ];
-    const answers = await (0, prompts_1.default)(questions);
-    return answers;
-}
-exports.showDepsInstallPrompt = showDepsInstallPrompt;
 function userAnswersAreValid(answers) {
     const { contract, frontend, projectName, tests } = answers;
     if ([contract, frontend, projectName, tests].includes(undefined)) {
@@ -156,7 +149,6 @@ async function promptAndGetConfig() {
     let isFromPrompts = false;
     // process cli args
     const args = await getUserArgs();
-    const { install } = args;
     const argsValid = validateUserArgs(args);
     if (argsValid === 'error') {
         show.argsError();
@@ -176,6 +168,7 @@ async function promptAndGetConfig() {
     if (process.platform === 'win32') {
         // TODO: track windows
         show.windowsWarning();
+        return null;
     }
     // Get user input
     if (config === null) {
@@ -189,21 +182,12 @@ async function promptAndGetConfig() {
     const { frontend, contract } = config;
     (0, tracking_1.trackUsage)(frontend, contract);
     let path = (0, exports.projectPath)(config.projectName);
-    // If dir exists keep asking user
+    // If dir exists warn and exit
     if (fs_1.default.existsSync(path)) {
-        if (!isFromPrompts) {
-            show.directoryExists(path);
-            return null;
-        }
-        else {
-            while (fs_1.default.existsSync(path)) {
-                show.directoryExists(path);
-                const { projectName: newProjectName } = await showProjectNamePrompt();
-                config.projectName = newProjectName;
-            }
-        }
+        show.directoryExists(path);
+        return null;
     }
-    return { config: { ...config, install }, projectPath: path, isFromPrompts };
+    return { config, projectPath: path, isFromPrompts };
 }
 exports.promptAndGetConfig = promptAndGetConfig;
 const projectPath = (projectName) => `${process.cwd()}/${projectName}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-near-app",
-  "version": "4.0.0-beta.3.0",
+  "version": "4.1.0",
   "description": "Quickly scaffold your dApp on NEAR Blockchain",
   "main": "index.js",
   "engines": {
@@ -16,7 +16,7 @@
   "scripts": {
     "start": "npm run build && node index.js",
     "build": "tsc",
-    "test": "npm run build && jest --runInBand",
+    "test": "npm run build && FORCE_COLOR=1 jest --runInBand",
     "test-e2e": "npm run build && ./test/e2e.sh",
     "lint": "eslint .",
     "fix": "eslint . --fix",
@@ -27,7 +27,6 @@
     "chalk": "^4.1.2",
     "commander": "^9.4.0",
     "cross-spawn": "^7.0.3",
-    "lodash": "^4.17.21",
     "mixpanel": "^0.16.0",
     "ncp": "^2.0.0",
     "prompts": "^2.4.2",
@@ -44,8 +43,6 @@
     "@types/node": "^18.6.1",
     "@types/prompts": "^2.0.14",
     "@types/semver": "^7.3.10",
-    "@typescript-eslint/eslint-plugin": "^5.26.0",
-    "@typescript-eslint/parser": "^5.26.0",
     "eslint": "^8.20.0",
     "eslint-config-react-app": "^7.0.1",
     "eslint-plugin-import": "^2.26.0",

package/templates/contracts/js/README.md

@@ -1,23 +1,79 @@
-Hello NEAR!
-=================================
+# Hello NEAR Contract
 
-A [smart contract] written with [NEAR JavaScript SDK] for an app initialized with [create-near-app]
+The smart contract exposes two methods to enable storing and retrieving a greeting in the NEAR network.
 
+```ts
+@NearBindgen({})
+class HelloNear {
+  greeting: string = "Hello";
 
-Quick Start
-===========
+  @view // This method is read-only and can be called for free
+  get_greeting(): string {
+    return this.greeting;
+  }
 
-1. Install dependencies: `npm install`
-2. Deploy to NEAR TestNet with a temporary dev account: `npm run deploy`
+  @call // This method changes the state, for which it cost gas
+  set_greeting({ greeting }: { greeting: string }): void {
+    // Record a log permanently to the blockchain!
+    near.log(`Saving greeting ${greeting}`);
+    this.greeting = greeting;
+  }
+}
+```
 
-Exploring The Code
-==================
+<br />
 
-1. The smart contract code is in `src/contract.ts`.
-2. There are two functions to the smart contract: `get_greeting` and `set_greeting`.
-3. Tests: Use integration-tests that `create-near-app` created for you.
+# Quickstart
 
+1. Make sure you have installed [node.js](https://nodejs.org/en/download/package-manager/) >= 16.
+2. Install the [`NEAR CLI`](https://github.com/near/near-cli#setup)
 
-  [smart contract]: https://docs.near.org/develop/welcome
-  [NEAR JavaScript SDK]: https://github.com/near/near-sdk-js
-  [create-near-app]: https://github.com/near/create-near-app
+<br />
+
+## 1. Build and Deploy the Contract
+You can automatically compile and deploy the contract in the NEAR testnet by running:
+
+```bash
+npm run deploy
+```
+
+Once finished, check the `neardev/dev-account` file to find the address in which the contract was deployed:
+
+```bash
+cat ./neardev/dev-account
+# e.g. dev-1659899566943-21539992274727
+```
+
+<br />
+
+## 2. Retrieve the Greeting
+
+`get_greeting` is a read-only method (aka `view` method).
+
+`View` methods can be called for **free** by anyone, even people **without a NEAR account**!
+
+```bash
+# Use near-cli to get the greeting
+near view <dev-account> get_greeting
+```
+
+<br />
+
+## 3. Store a New Greeting
+`set_greeting` changes the contract's state, for which it is a `call` method.
+
+`Call` methods can only be invoked using a NEAR account, since the account needs to pay GAS for the transaction.
+
+```bash
+# Use near-cli to set a new greeting
+near call <dev-account> set_greeting '{"greeting":"howdy"}' --accountId <dev-account>
+```
+
+**Tip:** If you would like to call `set_greeting` using your own account, first login into NEAR using:
+
+```bash
+# Use near-cli to login your NEAR account
+near login
+```
+
+and then use the logged account to sign the transaction: `--accountId <your-account>`.

package/templates/contracts/js/build.sh

@@ -0,0 +1,5 @@
+#!/bin/sh
+
+echo ">> Building contract"
+
+near-sdk-js build src/contract.ts build/hello_near.wasm

package/templates/contracts/js/deploy.sh

@@ -0,0 +1,13 @@
+#!/bin/sh
+
+./build.sh
+
+if [ $? -ne 0 ]; then
+  echo ">> Error building contract"
+  exit 1
+fi
+
+echo ">> Deploying contract"
+
+# https://docs.near.org/tools/near-cli#near-dev-deploy
+near dev-deploy --wasmFile build/hello_near.wasm

package/templates/contracts/js/package.json

@@ -4,13 +4,13 @@
   "license": "(MIT AND Apache-2.0)",
   "type": "module",
   "scripts": {
-    "build": "near-sdk-js build src/contract.ts build/hello_near.wasm",
-    "deploy": "npm run build && rm -rf neardev && near dev-deploy --wasmFile build/hello_near.wasm && export $(cat ./neardev/dev-account.env) && near call $CONTRACT_NAME init --accountId $CONTRACT_NAME --deposit 1 && echo $CONTRACT_NAME",
+    "build": "./build.sh",
+    "deploy": "./deploy.sh",
     "test": "echo use integration-tests"
   },
   "dependencies": {
     "near-cli": "^3.4.0",
-    "near-sdk-js": "0.4.0-4"
+    "near-sdk-js": "0.5.0-0"
   },
   "devDependencies": {
     "typescript": "^4.7.4"