@harperfast/template-react-studio 1.3.0 → 1.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -24,8 +24,9 @@ Guidelines for building scalable, secure, and performant applications on Harper.
|
|
|
24
24
|
- 3.4 [TypeScript Type Stripping](#34-typescript-type-stripping)
|
|
25
25
|
- 3.5 [Caching](#35-caching)
|
|
26
26
|
4. [Infrastructure & Ops](#4-infrastructure--ops) — **MEDIUM**
|
|
27
|
-
- 4.1 [
|
|
28
|
-
- 4.2 [
|
|
27
|
+
- 4.1 [Creating Harper Applications](#41-creating-harper-applications)
|
|
28
|
+
- 4.2 [Deploying to Harper Fabric](#42-deploying-to-harper-fabric)
|
|
29
|
+
- 4.3 [Serving Web Content](#43-serving-web-content)
|
|
29
30
|
|
|
30
31
|
---
|
|
31
32
|
|
|
@@ -240,7 +241,32 @@ How caching is defined and implemented in Harper applications.
|
|
|
240
241
|
|
|
241
242
|
**Impact: MEDIUM**
|
|
242
243
|
|
|
243
|
-
### 4.1
|
|
244
|
+
### 4.1 Creating Harper Applications
|
|
245
|
+
|
|
246
|
+
The fastest way to start a new Harper project is using the `create-harper` CLI tool. This command initializes a project with a standard folder structure, essential configuration files, and basic schema definitions.
|
|
247
|
+
|
|
248
|
+
#### When to Use
|
|
249
|
+
Use this command when starting a new Harper application or adding a new Harper microservice to an existing architecture.
|
|
250
|
+
|
|
251
|
+
#### Commands
|
|
252
|
+
Initialize a project using your preferred package manager:
|
|
253
|
+
|
|
254
|
+
**NPM**
|
|
255
|
+
```bash
|
|
256
|
+
npm create harper@latest
|
|
257
|
+
```
|
|
258
|
+
|
|
259
|
+
**PNPM**
|
|
260
|
+
```bash
|
|
261
|
+
pnpm create harper@latest
|
|
262
|
+
```
|
|
263
|
+
|
|
264
|
+
**Bun**
|
|
265
|
+
```bash
|
|
266
|
+
bun create harper@latest
|
|
267
|
+
```
|
|
268
|
+
|
|
269
|
+
### 4.2 Deploying to Harper Fabric
|
|
244
270
|
|
|
245
271
|
Globally scaling your Harper application.
|
|
246
272
|
|
|
@@ -249,7 +275,7 @@ Globally scaling your Harper application.
|
|
|
249
275
|
- **Automatic Sync**: Data is synced across the fabric automatically.
|
|
250
276
|
- **Free Tier**: Start for free and scale as you grow.
|
|
251
277
|
|
|
252
|
-
### 4.
|
|
278
|
+
### 4.3 Serving Web Content
|
|
253
279
|
|
|
254
280
|
Two ways to serve web content from a Harper application.
|
|
255
281
|
|
|
@@ -72,6 +72,7 @@ Reference these guidelines when:
|
|
|
72
72
|
### 4. Infrastructure & Ops (MEDIUM)
|
|
73
73
|
|
|
74
74
|
- `deploying-to-harper-fabric` - Scale globally with Harper Fabric
|
|
75
|
+
- `creating-harper-apps` - Quickstart with `npm create harper@latest`
|
|
75
76
|
- `serving-web-content` - Ways to serve web content from Harper
|
|
76
77
|
|
|
77
78
|
## How to Use
|
|
@@ -81,6 +82,7 @@ Read individual rule files for detailed explanations and code examples:
|
|
|
81
82
|
```
|
|
82
83
|
rules/adding-tables-with-schemas.md
|
|
83
84
|
rules/automatic-apis.md
|
|
85
|
+
rules/creating-harper-apps.md
|
|
84
86
|
```
|
|
85
87
|
|
|
86
88
|
## Full Compiled Document
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: creating-harper-apps
|
|
3
|
+
description: How to initialize a new Harper application using the CLI.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Creating Harper Applications
|
|
7
|
+
|
|
8
|
+
The fastest way to start a new Harper project is using the `create-harper` CLI tool. This command initializes a project with a standard folder structure, essential configuration files, and basic schema definitions.
|
|
9
|
+
|
|
10
|
+
## When to Use
|
|
11
|
+
|
|
12
|
+
Use this command when starting a new Harper application or adding a new Harper microservice to an existing architecture.
|
|
13
|
+
|
|
14
|
+
## Commands
|
|
15
|
+
|
|
16
|
+
Initialize a project using your preferred package manager:
|
|
17
|
+
|
|
18
|
+
### NPM
|
|
19
|
+
```bash
|
|
20
|
+
npm create harper@latest
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
### PNPM
|
|
24
|
+
```bash
|
|
25
|
+
pnpm create harper@latest
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
### Bun
|
|
29
|
+
```bash
|
|
30
|
+
bun create harper@latest
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Options
|
|
34
|
+
|
|
35
|
+
You can specify the project name and template directly:
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
npm create harper@latest my-app --template default
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
## Next Steps
|
|
42
|
+
|
|
43
|
+
1. **Configure Environment**: Set up your `.env` file with local or cloud credentials.
|
|
44
|
+
2. **Define Schema**: Modify `schema.graphql` to fit your application's data model.
|
|
45
|
+
3. **Start Development**: Run `npm run dev` to start the local Harper instance.
|
|
46
|
+
4. **Deploy**: Use `npm run deploy` to push your application to Harper Fabric.
|
package/package.json
CHANGED
package/skills-lock.json
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
"harper-best-practices": {
|
|
5
5
|
"source": "harperfast/skills",
|
|
6
6
|
"sourceType": "github",
|
|
7
|
-
"computedHash": "
|
|
7
|
+
"computedHash": "ad179fb2d4ba22ac7273aebe39883b7bb8fa97f6988e953360217dec6ddd41ee"
|
|
8
8
|
}
|
|
9
9
|
}
|
|
10
10
|
}
|