create-harper 0.13.1 → 1.1.0

package/README.svg

@@ -116,7 +116,7 @@
       class="sans"
       x="0"
       y="62"
-      font-size="96"
+      font-size="128"
       font-weight="800"
       letter-spacing="-1.5"
       fill="url(#harperGrad)"
@@ -145,10 +145,10 @@
         font-size="22"
         fill="#e6f7ff"
         opacity="0.96"
-      >$ npm create harper</text>
+      >$ npm create harper@latest</text>
 
       <!-- blinking cursor -->
-      <rect x="350" y="17" width="3" height="24" fill="#e6f7ff" opacity="0.55">
+      <rect x="440" y="16" width="12" height="24" fill="#e6f7ff" opacity="0.55">
         <animate
           attributeName="opacity"
           values="0.1;0.8;0.1"

package/lib/constants/renameFiles.js

@@ -3,9 +3,10 @@
  * @type {Record<string, string>}
  */
 export const renameFiles = {
+	'_env': '.env',
+	'_env.example': '.env.example',
 	_aiignore: '.aiignore',
-	_gitignore: '.gitignore',
 	_github: '.github',
-	'_env.example': '.env.example',
-	'_env': '.env',
+	_gitignore: '.gitignore',
+	_nvmrc: '.nvmrc',
 };

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "create-harper",
 	"description": "Scaffold a new Harper project in JavaScript or TypeScript.",
-	"version": "0.13.1",
+	"version": "1.1.0",
 	"type": "module",
 	"author": {
 		"name": "HarperDB",

package/template-react/AGENTS.md

@@ -6,16 +6,17 @@ This repository contains "skills" that guide AI agents in developing Harper appl
 
 - [Adding Tables with Schemas](skills/adding-tables-with-schemas.md): Learn how to define schemas and enable automatic REST APIs for your database tables with schema .graphql files in Harper.
 - [Automatic APIs](skills/automatic-apis.md): Details on the CRUD endpoints automatically generated for exported tables with REST and WebSockets.
-- [Querying REST APIs](skills/querying-rest-apis.md): How to use filters, operators, sorting, and pagination in REST requests.
-- [Programmatic Table Requests](skills/programmatic-table-requests.md): How to use filters, operators, sorting, and pagination in programmatic table requests.
+- [Caching](skills/caching.md): How caching is defined and implemented in Harper applications.
+- [Checking Authentication](skills/checking-authentication.md): How to use sessions to verify user identity and roles.
 - [Custom Resources](skills/custom-resources.md): How to define custom REST endpoints using JavaScript or TypeScript (Note: Paths are case-sensitive).
-- [Extending Table Resources](skills/extending-tables.md): Adding custom logic to automatically generated table resources.
 - [Defining Relationships](skills/defining-relationships.md): Using the `@relationship` directive to link tables.
-- [Real-time Applications](skills/real-time-apps.md): Implementing WebSockets and Pub/Sub for live data updates.
-- [TypeScript Type Stripping](skills/typescript-type-stripping.md): Using TypeScript directly without build tools via Node.js Type Stripping.
+- [Deploying to Harper Fabric](skills/deploying-to-harper-fabric.md): Globally scaling your Harper application with our generous Free tier and beyond.
+- [Extending Table Resources](skills/extending-tables.md): Adding custom logic to automatically generated table resources.
 - [Handling Binary Data](skills/handling-binary-data.md): How to store and serve binary data like images or MP3s.
+- [Programmatic Table Requests](skills/programmatic-table-requests.md): How to use filters, operators, sorting, and pagination in programmatic table requests.
+- [Querying REST APIs](skills/querying-rest-apis.md): How to use filters, operators, sorting, and pagination in REST requests.
+- [Real-time Applications](skills/real-time-apps.md): Implementing WebSockets and Pub/Sub for live data updates.
 - [Serving Web Content](skills/serving-web-content): Two ways to serve web content from a Harper application.
-- [Checking Authentication](skills/checking-authentication.md): How to use sessions to verify user identity and roles.
-- [Caching](skills/caching.md): How caching is defined and implemented in Harper applications.
+- [TypeScript Type Stripping](skills/typescript-type-stripping.md): Using TypeScript directly without build tools via Node.js Type Stripping.
 - [Using Blobs](skills/using-blob-datatype.md): How to store and retrieve large data in HarperDB.
 - [Vector Indexing](skills/vector-indexing.md): How to define and use vector indexes for efficient similarity search.

package/template-react/README.md

@@ -22,15 +22,62 @@ npm run dev
 
 ### Define Your Schema
 
-The [schemas/examplePeople.graphql](./schemas/examplePeople.graphql) is an example table schema definition. This is the main starting point for defining your database schema, specifying which tables you want and what attributes/fields they should have.
+1. Create a new yourTableName.graphql file in the [schemas](./schemas) directory.
+2. Craft your schema by hand.
+3. Save your changes.
 
-Open your [schemas/examplePeople.graphql](./schemas/examplePeople.graphql) to take a look at an example schema. You can add as many table definitions to a single schema file as you want. You can also create one file per schema.
-
-These schemas are the heart of a great Harper app. This is the main starting point for defining your database schema, specifying which tables you want and what attributes/fields they should have. REST endpoints will get stood up for any table that you `@export`.
+These schemas are the heart of a great Harper app, specifying which tables you want and what attributes/fields they should have. Any table you `@export` stands up [REST endpoints automatically](./skills/automatic-rest-apis.md).
 
 ### Add Custom Endpoints
 
-The [resources/greeting.js](./resources/greeting.js) provides a template for defining JavaScript resource classes, for customized application logic in your endpoints.
+1. Create a new greeting.js file in the [resources](./resources) directory.
+
+2. Customize your resource:
+
+   ```javascript
+   export class Greeting extends Resource {
+   	static loadAsInstance = false;
+
+   	async post(
+   		target,
+   		newRecord,
+   	) {
+   		// By default, only super users can access these endpoints.
+   		return { greeting: 'Greetings, post!' };
+   	}
+
+   	async get(target) {
+   		// But if we want anyone to be able to access it, we can turn off the permission checks!
+   		target.checkPermission = false;
+   		return { greeting: 'Greetings, get! ' + process.version };
+   	}
+
+   	async put(
+   		target,
+   		record,
+   	) {
+   		target.checkPermission = false;
+   		if (this.getCurrentUser()?.name?.includes('Coffee')) {
+   			// You can add your own authorization guards, of course.
+   			return new Response('Coffee? COFFEE?!', { status: 418 });
+   		}
+   		return { greeting: 'Sssssssssssssss!' };
+   	}
+
+   	async patch(
+   		target,
+   		record,
+   	) {
+   		return { greeting: 'We can make this work!' };
+   	}
+
+   	async delete(target) {
+   		return true;
+   	}
+   }
+   ```
+
+3. Save your changes.
 
 ### View Your Website
 
@@ -58,7 +105,7 @@ Take a look at the [default configuration](./config.yaml), which specifies how f
 
 When you are ready, head to [https://fabric.harper.fast/](https://fabric.harper.fast/), log in to your account, and create a cluster.
 
-Make sure you've configured your [.env](./.env) file with your secure cluster credentials. Don't commit this file to source control!
+Come back here and configure your [.env](./.env) file with your secure cluster credentials. Don't commit this file to source control!
 
 Then you can deploy your app to your cluster:
 

package/template-react/_nvmrc

@@ -0,0 +1 @@
+24.13.1

package/template-react/skills/deploying-to-harper-fabric.md

@@ -0,0 +1,20 @@
+# Deploying to Harper Fabric
+
+To deploy your application to Harper Fabric, follow these steps:
+
+1. **Sign up**: Create an account at [https://fabric.harper.fast](https://fabric.harper.fast) and create a cluster.
+
+2. **Configure Environment**: Add your credentials and cluster URL to your `.env` file:
+   ```bash
+   # Deployments
+   CLI_TARGET_USERNAME='YOUR_CLUSTER_USERNAME'
+   CLI_TARGET_PASSWORD='YOUR_CLUSTER_PASSWORD'
+   CLI_TARGET='YOUR_FABRIC.HARPER.FAST_CLUSTER_URL_HERE'
+   ```
+
+3. **Deploy Locally**: Run the following command to deploy from your local environment:
+   ```bash
+   npm run deploy
+   ```
+
+4. **Set up CI/CD**: Customize the included `.github/workflow/deploy.yaml` file and define your secrets in your GitHub repository's action settings to enable continuous deployment.

package/template-react-ts/AGENTS.md

@@ -6,16 +6,17 @@ This repository contains "skills" that guide AI agents in developing Harper appl
 
 - [Adding Tables with Schemas](skills/adding-tables-with-schemas.md): Learn how to define schemas and enable automatic REST APIs for your database tables with schema .graphql files in Harper.
 - [Automatic APIs](skills/automatic-apis.md): Details on the CRUD endpoints automatically generated for exported tables with REST and WebSockets.
-- [Querying REST APIs](skills/querying-rest-apis.md): How to use filters, operators, sorting, and pagination in REST requests.
-- [Programmatic Table Requests](skills/programmatic-table-requests.md): How to use filters, operators, sorting, and pagination in programmatic table requests.
+- [Caching](skills/caching.md): How caching is defined and implemented in Harper applications.
+- [Checking Authentication](skills/checking-authentication.md): How to use sessions to verify user identity and roles.
 - [Custom Resources](skills/custom-resources.md): How to define custom REST endpoints using JavaScript or TypeScript (Note: Paths are case-sensitive).
-- [Extending Table Resources](skills/extending-tables.md): Adding custom logic to automatically generated table resources.
 - [Defining Relationships](skills/defining-relationships.md): Using the `@relationship` directive to link tables.
-- [Real-time Applications](skills/real-time-apps.md): Implementing WebSockets and Pub/Sub for live data updates.
-- [TypeScript Type Stripping](skills/typescript-type-stripping.md): Using TypeScript directly without build tools via Node.js Type Stripping.
+- [Deploying to Harper Fabric](skills/deploying-to-harper-fabric.md): Globally scaling your Harper application with our generous Free tier and beyond.
+- [Extending Table Resources](skills/extending-tables.md): Adding custom logic to automatically generated table resources.
 - [Handling Binary Data](skills/handling-binary-data.md): How to store and serve binary data like images or MP3s.
+- [Programmatic Table Requests](skills/programmatic-table-requests.md): How to use filters, operators, sorting, and pagination in programmatic table requests.
+- [Querying REST APIs](skills/querying-rest-apis.md): How to use filters, operators, sorting, and pagination in REST requests.
+- [Real-time Applications](skills/real-time-apps.md): Implementing WebSockets and Pub/Sub for live data updates.
 - [Serving Web Content](skills/serving-web-content): Two ways to serve web content from a Harper application.
-- [Checking Authentication](skills/checking-authentication.md): How to use sessions to verify user identity and roles.
-- [Caching](skills/caching.md): How caching is defined and implemented in Harper applications.
+- [TypeScript Type Stripping](skills/typescript-type-stripping.md): Using TypeScript directly without build tools via Node.js Type Stripping.
 - [Using Blobs](skills/using-blob-datatype.md): How to store and retrieve large data in HarperDB.
 - [Vector Indexing](skills/vector-indexing.md): How to define and use vector indexes for efficient similarity search.

package/template-react-ts/README.md

@@ -24,15 +24,72 @@ TypeScript is supported at runtime in Node.js through [type stripping](https://n
 
 ### Define Your Schema
 
-The [schemas/examplePeople.graphql](./schemas/examplePeople.graphql) is an example table schema definition. This is the main starting point for defining your database schema, specifying which tables you want and what attributes/fields they should have.
+1. Create a new yourTableName.graphql file in the [schemas](./schemas) directory.
+2. Craft your schema by hand.
+3. Save your changes.
 
-Open your [schemas/examplePeople.graphql](./schemas/examplePeople.graphql) to take a look at an example schema. You can add as many table definitions to a single schema file as you want. You can also create one file per schema.
-
-These schemas are the heart of a great Harper app. This is the main starting point for defining your database schema, specifying which tables you want and what attributes/fields they should have. REST endpoints will get stood up for any table that you `@export`.
+These schemas are the heart of a great Harper app, specifying which tables you want and what attributes/fields they should have. Any table you `@export` stands up [REST endpoints automatically](./skills/automatic-rest-apis.md).
 
 ### Add Custom Endpoints
 
-The [resources/greeting.ts](./resources/greeting.ts) provides a template for defining TypeScript resource classes, for customized application logic in your endpoints.
+1. Create a new greeting.ts file in the [resources](./resources) directory.
+
+2. Customize your resource:
+
+   ```typescript
+   import {
+   	type RecordObject,
+   	type RequestTargetOrId,
+   	Resource,
+   } from 'harperdb';
+
+   interface GreetingRecord {
+   	greeting: string;
+   }
+
+   export class Greeting extends Resource<GreetingRecord> {
+   	static loadAsInstance = false;
+
+   	async post(
+   		target: RequestTargetOrId,
+   		newRecord: Partial<GreetingRecord & RecordObject>,
+   	): Promise<GreetingRecord> {
+   		// By default, only super users can access these endpoints.
+   		return { greeting: 'Greetings, post!' };
+   	}
+
+   	async get(target?: RequestTargetOrId): Promise<GreetingRecord> {
+   		// But if we want anyone to be able to access it, we can turn off the permission checks!
+   		target.checkPermission = false;
+   		return { greeting: 'Greetings, get! ' + process.version };
+   	}
+
+   	async put(
+   		target: RequestTargetOrId,
+   		record: GreetingRecord & RecordObject,
+   	): Promise<GreetingRecord> {
+   		target.checkPermission = false;
+   		if (this.getCurrentUser()?.name?.includes('Coffee')) {
+   			// You can add your own authorization guards, of course.
+   			return new Response('Coffee? COFFEE?!', { status: 418 });
+   		}
+   		return { greeting: 'Sssssssssssssss!' };
+   	}
+
+   	async patch(
+   		target: RequestTargetOrId,
+   		record: Partial<GreetingRecord & RecordObject>,
+   	): Promise<GreetingRecord> {
+   		return { greeting: 'We can make this work!' };
+   	}
+
+   	async delete(target: RequestTargetOrId): Promise<boolean> {
+   		return true;
+   	}
+   }
+   ```
+
+3. Save your changes.
 
 ### View Your Website
 
@@ -60,7 +117,7 @@ Take a look at the [default configuration](./config.yaml), which specifies how f
 
 When you are ready, head to [https://fabric.harper.fast/](https://fabric.harper.fast/), log in to your account, and create a cluster.
 
-Make sure you've configured your [.env](./.env) file with your secure cluster credentials. Don't commit this file to source control!
+Come back here and configure your [.env](./.env) file with your secure cluster credentials. Don't commit this file to source control!
 
 Then you can deploy your app to your cluster:
 

package/template-react-ts/_nvmrc

@@ -0,0 +1 @@
+24.13.1

package/template-react-ts/skills/deploying-to-harper-fabric.md

@@ -0,0 +1,20 @@
+# Deploying to Harper Fabric
+
+To deploy your application to Harper Fabric, follow these steps:
+
+1. **Sign up**: Create an account at [https://fabric.harper.fast](https://fabric.harper.fast) and create a cluster.
+
+2. **Configure Environment**: Add your credentials and cluster URL to your `.env` file:
+   ```bash
+   # Deployments
+   CLI_TARGET_USERNAME='YOUR_CLUSTER_USERNAME'
+   CLI_TARGET_PASSWORD='YOUR_CLUSTER_PASSWORD'
+   CLI_TARGET='YOUR_FABRIC.HARPER.FAST_CLUSTER_URL_HERE'
+   ```
+
+3. **Deploy Locally**: Run the following command to deploy from your local environment:
+   ```bash
+   npm run deploy
+   ```
+
+4. **Set up CI/CD**: Customize the included `.github/workflow/deploy.yaml` file and define your secrets in your GitHub repository's action settings to enable continuous deployment.

package/template-vanilla/AGENTS.md

@@ -6,16 +6,17 @@ This repository contains "skills" that guide AI agents in developing Harper appl
 
 - [Adding Tables with Schemas](skills/adding-tables-with-schemas.md): Learn how to define schemas and enable automatic REST APIs for your database tables with schema .graphql files in Harper.
 - [Automatic APIs](skills/automatic-apis.md): Details on the CRUD endpoints automatically generated for exported tables with REST and WebSockets.
-- [Querying REST APIs](skills/querying-rest-apis.md): How to use filters, operators, sorting, and pagination in REST requests.
-- [Programmatic Table Requests](skills/programmatic-table-requests.md): How to use filters, operators, sorting, and pagination in programmatic table requests.
+- [Caching](skills/caching.md): How caching is defined and implemented in Harper applications.
+- [Checking Authentication](skills/checking-authentication.md): How to use sessions to verify user identity and roles.
 - [Custom Resources](skills/custom-resources.md): How to define custom REST endpoints using JavaScript or TypeScript (Note: Paths are case-sensitive).
-- [Extending Table Resources](skills/extending-tables.md): Adding custom logic to automatically generated table resources.
 - [Defining Relationships](skills/defining-relationships.md): Using the `@relationship` directive to link tables.
-- [Real-time Applications](skills/real-time-apps.md): Implementing WebSockets and Pub/Sub for live data updates.
-- [TypeScript Type Stripping](skills/typescript-type-stripping.md): Using TypeScript directly without build tools via Node.js Type Stripping.
+- [Deploying to Harper Fabric](skills/deploying-to-harper-fabric.md): Globally scaling your Harper application with our generous Free tier and beyond.
+- [Extending Table Resources](skills/extending-tables.md): Adding custom logic to automatically generated table resources.
 - [Handling Binary Data](skills/handling-binary-data.md): How to store and serve binary data like images or MP3s.
+- [Programmatic Table Requests](skills/programmatic-table-requests.md): How to use filters, operators, sorting, and pagination in programmatic table requests.
+- [Querying REST APIs](skills/querying-rest-apis.md): How to use filters, operators, sorting, and pagination in REST requests.
+- [Real-time Applications](skills/real-time-apps.md): Implementing WebSockets and Pub/Sub for live data updates.
 - [Serving Web Content](skills/serving-web-content): Two ways to serve web content from a Harper application.
-- [Checking Authentication](skills/checking-authentication.md): How to use sessions to verify user identity and roles.
-- [Caching](skills/caching.md): How caching is defined and implemented in Harper applications.
+- [TypeScript Type Stripping](skills/typescript-type-stripping.md): Using TypeScript directly without build tools via Node.js Type Stripping.
 - [Using Blobs](skills/using-blob-datatype.md): How to store and retrieve large data in HarperDB.
 - [Vector Indexing](skills/vector-indexing.md): How to define and use vector indexes for efficient similarity search.

package/template-vanilla/README.md

@@ -22,15 +22,62 @@ npm run dev
 
 ### Define Your Schema
 
-The [schemas/examplePeople.graphql](./schemas/examplePeople.graphql) is an example table schema definition. This is the main starting point for defining your database schema, specifying which tables you want and what attributes/fields they should have.
+1. Create a new yourTableName.graphql file in the [schemas](./schemas) directory.
+2. Craft your schema by hand.
+3. Save your changes.
 
-Open your [schemas/examplePeople.graphql](./schemas/examplePeople.graphql) to take a look at an example schema. You can add as many table definitions to a single schema file as you want. You can also create one file per schema.
-
-These schemas are the heart of a great Harper app. This is the main starting point for defining your database schema, specifying which tables you want and what attributes/fields they should have. REST endpoints will get stood up for any table that you `@export`.
+These schemas are the heart of a great Harper app, specifying which tables you want and what attributes/fields they should have. Any table you `@export` stands up [REST endpoints automatically](./skills/automatic-rest-apis.md).
 
 ### Add Custom Endpoints
 
-The [resources/greeting.js](./resources/greeting.js) provides a template for defining JavaScript resource classes, for customized application logic in your endpoints.
+1. Create a new greeting.js file in the [resources](./resources) directory.
+
+2. Customize your resource:
+
+   ```javascript
+   export class Greeting extends Resource {
+   	static loadAsInstance = false;
+
+   	async post(
+   		target,
+   		newRecord,
+   	) {
+   		// By default, only super users can access these endpoints.
+   		return { greeting: 'Greetings, post!' };
+   	}
+
+   	async get(target) {
+   		// But if we want anyone to be able to access it, we can turn off the permission checks!
+   		target.checkPermission = false;
+   		return { greeting: 'Greetings, get! ' + process.version };
+   	}
+
+   	async put(
+   		target,
+   		record,
+   	) {
+   		target.checkPermission = false;
+   		if (this.getCurrentUser()?.name?.includes('Coffee')) {
+   			// You can add your own authorization guards, of course.
+   			return new Response('Coffee? COFFEE?!', { status: 418 });
+   		}
+   		return { greeting: 'Sssssssssssssss!' };
+   	}
+
+   	async patch(
+   		target,
+   		record,
+   	) {
+   		return { greeting: 'We can make this work!' };
+   	}
+
+   	async delete(target) {
+   		return true;
+   	}
+   }
+   ```
+
+3. Save your changes.
 
 ### View Your Website
 
@@ -58,7 +105,7 @@ Take a look at the [default configuration](./config.yaml), which specifies how f
 
 When you are ready, head to [https://fabric.harper.fast/](https://fabric.harper.fast/), log in to your account, and create a cluster.
 
-Make sure you've configured your [.env](./.env) file with your secure cluster credentials. Don't commit this file to source control!
+Come back here and configure your [.env](./.env) file with your secure cluster credentials. Don't commit this file to source control!
 
 Then you can deploy your app to your cluster:
 

package/template-vanilla/_github/workflow/deploy.yaml

@@ -0,0 +1,33 @@
+name: Deploy to Harper Fabric
+on:
+  workflow_dispatch:
+#  push:
+#    branches:
+#      - main
+
+concurrency:
+  group: main
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+      - name: Set up Node.js
+        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
+        with:
+          cache: 'npm'
+          node-version-file: '.nvmrc'
+      - name: Install dependencies
+        run: npm ci
+      - name: Run unit tests
+        run: npm test
+      - name: Run lint
+        run: npm run lint
+      - name: Deploy
+        run: npm run deploy

package/template-vanilla/_nvmrc

@@ -0,0 +1 @@
+24.13.1

package/template-vanilla/package.json

@@ -7,7 +7,9 @@
 		"start": "harperdb run .",
 		"dev": "harperdb dev .",
 		"deploy": "dotenv -- npm run deploy:component",
-		"deploy:component": "harperdb deploy_component . restart=rolling replicated=true"
+		"deploy:component": "harperdb deploy_component . restart=rolling replicated=true",
+		"test": "echo 'No tests implemented yet'",
+		"lint": "echo 'No lint implemented yet'"
 	},
 	"devDependencies": {
 		"dotenv-cli": "^11.0.0",

package/template-vanilla/skills/deploying-to-harper-fabric.md

@@ -0,0 +1,20 @@
+# Deploying to Harper Fabric
+
+To deploy your application to Harper Fabric, follow these steps:
+
+1. **Sign up**: Create an account at [https://fabric.harper.fast](https://fabric.harper.fast) and create a cluster.
+
+2. **Configure Environment**: Add your credentials and cluster URL to your `.env` file:
+   ```bash
+   # Deployments
+   CLI_TARGET_USERNAME='YOUR_CLUSTER_USERNAME'
+   CLI_TARGET_PASSWORD='YOUR_CLUSTER_PASSWORD'
+   CLI_TARGET='YOUR_FABRIC.HARPER.FAST_CLUSTER_URL_HERE'
+   ```
+
+3. **Deploy Locally**: Run the following command to deploy from your local environment:
+   ```bash
+   npm run deploy
+   ```
+
+4. **Set up CI/CD**: Customize the included `.github/workflow/deploy.yaml` file and define your secrets in your GitHub repository's action settings to enable continuous deployment.

package/template-vanilla-ts/AGENTS.md

@@ -6,16 +6,17 @@ This repository contains "skills" that guide AI agents in developing Harper appl
 
 - [Adding Tables with Schemas](skills/adding-tables-with-schemas.md): Learn how to define schemas and enable automatic REST APIs for your database tables with schema .graphql files in Harper.
 - [Automatic APIs](skills/automatic-apis.md): Details on the CRUD endpoints automatically generated for exported tables with REST and WebSockets.
-- [Querying REST APIs](skills/querying-rest-apis.md): How to use filters, operators, sorting, and pagination in REST requests.
-- [Programmatic Table Requests](skills/programmatic-table-requests.md): How to use filters, operators, sorting, and pagination in programmatic table requests.
+- [Caching](skills/caching.md): How caching is defined and implemented in Harper applications.
+- [Checking Authentication](skills/checking-authentication.md): How to use sessions to verify user identity and roles.
 - [Custom Resources](skills/custom-resources.md): How to define custom REST endpoints using JavaScript or TypeScript (Note: Paths are case-sensitive).
-- [Extending Table Resources](skills/extending-tables.md): Adding custom logic to automatically generated table resources.
 - [Defining Relationships](skills/defining-relationships.md): Using the `@relationship` directive to link tables.
-- [Real-time Applications](skills/real-time-apps.md): Implementing WebSockets and Pub/Sub for live data updates.
-- [TypeScript Type Stripping](skills/typescript-type-stripping.md): Using TypeScript directly without build tools via Node.js Type Stripping.
+- [Deploying to Harper Fabric](skills/deploying-to-harper-fabric.md): Globally scaling your Harper application with our generous Free tier and beyond.
+- [Extending Table Resources](skills/extending-tables.md): Adding custom logic to automatically generated table resources.
 - [Handling Binary Data](skills/handling-binary-data.md): How to store and serve binary data like images or MP3s.
+- [Programmatic Table Requests](skills/programmatic-table-requests.md): How to use filters, operators, sorting, and pagination in programmatic table requests.
+- [Querying REST APIs](skills/querying-rest-apis.md): How to use filters, operators, sorting, and pagination in REST requests.
+- [Real-time Applications](skills/real-time-apps.md): Implementing WebSockets and Pub/Sub for live data updates.
 - [Serving Web Content](skills/serving-web-content): Two ways to serve web content from a Harper application.
-- [Checking Authentication](skills/checking-authentication.md): How to use sessions to verify user identity and roles.
-- [Caching](skills/caching.md): How caching is defined and implemented in Harper applications.
+- [TypeScript Type Stripping](skills/typescript-type-stripping.md): Using TypeScript directly without build tools via Node.js Type Stripping.
 - [Using Blobs](skills/using-blob-datatype.md): How to store and retrieve large data in HarperDB.
 - [Vector Indexing](skills/vector-indexing.md): How to define and use vector indexes for efficient similarity search.

package/template-vanilla-ts/README.md

@@ -24,15 +24,72 @@ TypeScript is supported at runtime in Node.js through [type stripping](https://n
 
 ### Define Your Schema
 
-The [schemas/examplePeople.graphql](./schemas/examplePeople.graphql) is an example table schema definition. This is the main starting point for defining your database schema, specifying which tables you want and what attributes/fields they should have.
+1. Create a new yourTableName.graphql file in the [schemas](./schemas) directory.
+2. Craft your schema by hand.
+3. Save your changes.
 
-Open your [schemas/examplePeople.graphql](./schemas/examplePeople.graphql) to take a look at an example schema. You can add as many table definitions to a single schema file as you want. You can also create one file per schema.
-
-These schemas are the heart of a great Harper app. This is the main starting point for defining your database schema, specifying which tables you want and what attributes/fields they should have. REST endpoints will get stood up for any table that you `@export`.
+These schemas are the heart of a great Harper app, specifying which tables you want and what attributes/fields they should have. Any table you `@export` stands up [REST endpoints automatically](./skills/automatic-rest-apis.md).
 
 ### Add Custom Endpoints
 
-The [resources/greeting.ts](./resources/greeting.ts) provides a template for defining TypeScript resource classes, for customized application logic in your endpoints.
+1. Create a new greeting.ts file in the [resources](./resources) directory.
+
+2. Customize your resource:
+
+   ```typescript
+   import {
+   	type RecordObject,
+   	type RequestTargetOrId,
+   	Resource,
+   } from 'harperdb';
+
+   interface GreetingRecord {
+   	greeting: string;
+   }
+
+   export class Greeting extends Resource<GreetingRecord> {
+   	static loadAsInstance = false;
+
+   	async post(
+   		target: RequestTargetOrId,
+   		newRecord: Partial<GreetingRecord & RecordObject>,
+   	): Promise<GreetingRecord> {
+   		// By default, only super users can access these endpoints.
+   		return { greeting: 'Greetings, post!' };
+   	}
+
+   	async get(target?: RequestTargetOrId): Promise<GreetingRecord> {
+   		// But if we want anyone to be able to access it, we can turn off the permission checks!
+   		target.checkPermission = false;
+   		return { greeting: 'Greetings, get! ' + process.version };
+   	}
+
+   	async put(
+   		target: RequestTargetOrId,
+   		record: GreetingRecord & RecordObject,
+   	): Promise<GreetingRecord> {
+   		target.checkPermission = false;
+   		if (this.getCurrentUser()?.name?.includes('Coffee')) {
+   			// You can add your own authorization guards, of course.
+   			return new Response('Coffee? COFFEE?!', { status: 418 });
+   		}
+   		return { greeting: 'Sssssssssssssss!' };
+   	}
+
+   	async patch(
+   		target: RequestTargetOrId,
+   		record: Partial<GreetingRecord & RecordObject>,
+   	): Promise<GreetingRecord> {
+   		return { greeting: 'We can make this work!' };
+   	}
+
+   	async delete(target: RequestTargetOrId): Promise<boolean> {
+   		return true;
+   	}
+   }
+   ```
+
+3. Save your changes.
 
 ### View Your Website
 
@@ -60,7 +117,7 @@ Take a look at the [default configuration](./config.yaml), which specifies how f
 
 When you are ready, head to [https://fabric.harper.fast/](https://fabric.harper.fast/), log in to your account, and create a cluster.
 
-Make sure you've configured your [.env](./.env) file with your secure cluster credentials. Don't commit this file to source control!
+Come back here and configure your [.env](./.env) file with your secure cluster credentials. Don't commit this file to source control!
 
 Then you can deploy your app to your cluster:
 

package/template-vanilla-ts/_github/workflow/deploy.yaml

@@ -0,0 +1,33 @@
+name: Deploy to Harper Fabric
+on:
+  workflow_dispatch:
+#  push:
+#    branches:
+#      - main
+
+concurrency:
+  group: main
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+      - name: Set up Node.js
+        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
+        with:
+          cache: 'npm'
+          node-version-file: '.nvmrc'
+      - name: Install dependencies
+        run: npm ci
+      - name: Run unit tests
+        run: npm test
+      - name: Run lint
+        run: npm run lint
+      - name: Deploy
+        run: npm run deploy

package/template-vanilla-ts/_nvmrc

@@ -0,0 +1 @@
+24.13.1

package/template-vanilla-ts/package.json

@@ -7,7 +7,9 @@
 		"start": "harperdb run .",
 		"dev": "harperdb dev .",
 		"deploy": "dotenv -- npm run deploy:component",
-		"deploy:component": "harperdb deploy_component . restart=rolling replicated=true"
+		"deploy:component": "harperdb deploy_component . restart=rolling replicated=true",
+		"test": "echo 'No tests implemented yet'",
+		"lint": "echo 'No lint implemented yet'"
 	},
 	"devDependencies": {
 		"dotenv-cli": "^11.0.0",

package/template-vanilla-ts/skills/deploying-to-harper-fabric.md

@@ -0,0 +1,20 @@
+# Deploying to Harper Fabric
+
+To deploy your application to Harper Fabric, follow these steps:
+
+1. **Sign up**: Create an account at [https://fabric.harper.fast](https://fabric.harper.fast) and create a cluster.
+
+2. **Configure Environment**: Add your credentials and cluster URL to your `.env` file:
+   ```bash
+   # Deployments
+   CLI_TARGET_USERNAME='YOUR_CLUSTER_USERNAME'
+   CLI_TARGET_PASSWORD='YOUR_CLUSTER_PASSWORD'
+   CLI_TARGET='YOUR_FABRIC.HARPER.FAST_CLUSTER_URL_HERE'
+   ```
+
+3. **Deploy Locally**: Run the following command to deploy from your local environment:
+   ```bash
+   npm run deploy
+   ```
+
+4. **Set up CI/CD**: Customize the included `.github/workflow/deploy.yaml` file and define your secrets in your GitHub repository's action settings to enable continuous deployment.