create-githat-app 1.0.10 → 1.0.13
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.
- package/README.md +13 -18
- package/dist/cli.js +267 -180
- package/package.json +1 -1
- package/templates/base/.env.local.example.hbs +20 -0
- package/templates/base/README.md.hbs +31 -52
- package/templates/fullstack/apps-api-express/package.json.hbs +1 -1
- package/templates/fullstack/apps-api-fastify/package.json.hbs +1 -1
- package/templates/fullstack/apps-api-hono/package.json.hbs +1 -1
- package/templates/fullstack/apps-web-nextjs/app/globals.css.hbs +4 -3
- package/templates/fullstack/apps-web-nextjs/app/layout.tsx.hbs +5 -1
- package/templates/fullstack/apps-web-nextjs/app/page.tsx.hbs +2 -3
- package/templates/fullstack/apps-web-nextjs/package.json.hbs +2 -1
- package/templates/nextjs/.github/workflows/deploy.yml.hbs +107 -0
- package/templates/nextjs/app/globals.css.hbs +4 -3
- package/templates/nextjs/app/layout.tsx.hbs +5 -1
- package/templates/nextjs/app/page.tsx.hbs +3 -6
- package/templates/nextjs/next.config.ts.hbs +3 -1
- package/templates/react-vite/src/App.tsx.hbs +11 -9
- package/templates/react-vite/src/index.css.hbs +4 -3
- package/templates/react-vite/src/pages/Home.tsx.hbs +3 -6
package/README.md
CHANGED
|
@@ -14,9 +14,9 @@
|
|
|
14
14
|
|
|
15
15
|
---
|
|
16
16
|
|
|
17
|
-
Scaffold a production-ready app with a fully-managed backend — auth, teams, orgs, API keys,
|
|
17
|
+
Scaffold a production-ready app with a fully-managed backend — auth, teams, orgs, API keys, and AI agent identity. **No backend to deploy.**
|
|
18
18
|
|
|
19
|
-
[GitHat](https://githat.io) is your backend. When you run `create-githat-app`, your generated project connects to GitHat's hosted platform at `api.githat.io`. User accounts, organizations, teams, API keys,
|
|
19
|
+
[GitHat](https://githat.io) is your backend. When you run `create-githat-app`, your generated project connects to GitHat's hosted platform at `api.githat.io`. User accounts, organizations, teams, API keys, and AI agents are all stored and managed by GitHat. You write frontend code only.
|
|
20
20
|
|
|
21
21
|
## Install & Launch
|
|
22
22
|
|
|
@@ -75,7 +75,6 @@ The CLI asks you a series of questions:
|
|
|
75
75
|
│ ◻ Forgot password
|
|
76
76
|
│ ◻ Email verification
|
|
77
77
|
│ ◻ Organization management
|
|
78
|
-
│ ◻ MCP server identity
|
|
79
78
|
│ ◻ AI agent identity
|
|
80
79
|
│
|
|
81
80
|
◆ Database?
|
|
@@ -146,11 +145,11 @@ npx create-githat-app --version
|
|
|
146
145
|
|
|
147
146
|
A production-ready project connected to GitHat's hosted backend:
|
|
148
147
|
|
|
149
|
-
- **Fully-managed backend** — `api.githat.io` handles auth, orgs, teams, API keys, agents
|
|
148
|
+
- **Fully-managed backend** — `api.githat.io` handles auth, orgs, teams, API keys, and agents
|
|
150
149
|
- **Auth pages** — sign-in, sign-up, forgot password, email verification
|
|
151
150
|
- **Protected dashboard** — sidebar navigation, org switcher, user button
|
|
152
151
|
- **`@githat/nextjs` SDK** — `<GitHatProvider>`, `<ProtectedRoute>`, `useAuth()`
|
|
153
|
-
- **`githat/` platform folder** — typed API client for
|
|
152
|
+
- **`githat/` platform folder** — typed API client for the full REST API
|
|
154
153
|
- **Dark theme** — zinc/purple design system out of the box
|
|
155
154
|
- **Database ready** — Prisma or Drizzle for your app's own data (optional)
|
|
156
155
|
- **Tailwind CSS 4** — utility-first styling (optional)
|
|
@@ -168,7 +167,6 @@ githat/
|
|
|
168
167
|
auth.ts # Login, register, forgot password, verify email
|
|
169
168
|
orgs.ts # Create/update orgs, invite/remove members
|
|
170
169
|
users.ts # List orgs, switch org
|
|
171
|
-
mcp.ts # Register/verify MCP servers
|
|
172
170
|
agents.ts # Register/verify AI agent wallets
|
|
173
171
|
auth/
|
|
174
172
|
guard.tsx # Role-based route protection component
|
|
@@ -179,7 +177,6 @@ githat/
|
|
|
179
177
|
apps.tsx # App + API key management
|
|
180
178
|
members.tsx # Invite members, manage roles, remove
|
|
181
179
|
settings.tsx # Edit org name, brand color, save
|
|
182
|
-
mcp-servers.tsx # Register MCP servers, verify, remove
|
|
183
180
|
agents.tsx # Register AI agent wallets, verify, remove
|
|
184
181
|
```
|
|
185
182
|
|
|
@@ -193,23 +190,21 @@ You don't deploy or maintain a backend. GitHat's hosted platform handles:
|
|
|
193
190
|
- **Organizations** — create, switch, branding, custom domains
|
|
194
191
|
- **Team management** — invite members by email, assign roles (owner/admin/member), remove
|
|
195
192
|
- **API key management** — publishable + secret keys per app, rotation
|
|
196
|
-
- **MCP server registration** — domain verification via DNS TXT, OAuth2 credentials
|
|
197
193
|
- **AI agent registration** — Ethereum wallet verification, challenge-response tokens
|
|
198
194
|
- **Email delivery** — verification emails, invitations, password resets (via AWS SES)
|
|
199
|
-
- **Database** — users, orgs, teams, apps, agents
|
|
200
|
-
- **Public verification** — anyone can verify an agent
|
|
195
|
+
- **Database** — users, orgs, teams, apps, and agents (DynamoDB, managed by GitHat)
|
|
196
|
+
- **Public verification** — anyone can verify an agent at `githat.io/verify/`
|
|
201
197
|
|
|
202
198
|
Your data lives in GitHat's infrastructure. You write frontend code, GitHat handles the rest.
|
|
203
199
|
|
|
204
|
-
##
|
|
200
|
+
## Two Identity Types
|
|
205
201
|
|
|
206
|
-
GitHat supports
|
|
202
|
+
GitHat supports two types of identity in a single platform:
|
|
207
203
|
|
|
208
|
-
| Type
|
|
209
|
-
|
|
|
210
|
-
| **Humans**
|
|
211
|
-
| **
|
|
212
|
-
| **AI Agents** | Ethereum wallet signatures | AI Agents |
|
|
204
|
+
| Type | Auth Method | Dashboard Page |
|
|
205
|
+
| ------------- | -------------------------- | -------------- |
|
|
206
|
+
| **Humans** | Email + password | Members |
|
|
207
|
+
| **AI Agents** | Ethereum wallet signatures | AI Agents |
|
|
213
208
|
|
|
214
209
|
## Project Structure
|
|
215
210
|
|
|
@@ -281,7 +276,7 @@ VITE_GITHAT_API_URL=https://api.githat.io
|
|
|
281
276
|
|
|
282
277
|
- [GitHat Quick Start](https://githat.io/docs/quickstart) — Get running in 5 minutes
|
|
283
278
|
- [SDK Reference](https://githat.io/docs/sdk) — `@githat/nextjs` hooks, components, and server utils
|
|
284
|
-
- [API Reference](https://githat.io/docs/api) —
|
|
279
|
+
- [API Reference](https://githat.io/docs/api) — Full REST API reference
|
|
285
280
|
- [CLI Reference](https://githat.io/docs/cli) — Flags, prompts, and templates
|
|
286
281
|
- [Next.js Guide](https://githat.io/docs/nextjs) — Auth in Next.js 14-16+
|
|
287
282
|
- [React Guide](https://githat.io/docs/react) — Auth in any React app
|