create-githat-app 1.2.3 → 1.4.0
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 +48 -18
- package/dist/cli.js +1161 -114
- package/package.json +34 -9
- package/templates/agent/app/(auth)/sign-in/page.tsx.hbs +9 -0
- package/templates/agent/app/(auth)/sign-up/page.tsx.hbs +9 -0
- package/templates/agent/app/admin/agent/page.tsx.hbs +127 -0
- package/templates/agent/app/globals.css.hbs +87 -0
- package/templates/agent/app/layout.tsx.hbs +41 -0
- package/templates/agent/app/page.tsx.hbs +100 -0
- package/templates/agent/next.config.ts.hbs +8 -0
- package/templates/agent/postcss.config.mjs.hbs +14 -0
- package/templates/agent/proxy.ts.hbs +10 -0
- package/templates/agent/tsconfig.json.hbs +21 -0
- package/templates/base/.env.example.hbs +2 -2
- package/templates/base/.env.local.example.hbs +20 -0
- package/templates/base/.env.local.hbs +13 -2
- package/templates/base/.github/CODEOWNERS.hbs +1 -0
- package/templates/base/.github/SECURITY.md +10 -0
- package/templates/base/.github/dependabot.yml +19 -0
- package/templates/base/.github/workflows/ci.yml.hbs +77 -0
- package/templates/base/.github/workflows/githat-policy.yml +51 -0
- package/templates/base/.gitignore.hbs +17 -2
- package/templates/base/README.md.hbs +31 -52
- package/templates/classroom/app/(auth)/sign-in/page.tsx.hbs +9 -0
- package/templates/classroom/app/(auth)/sign-up/page.tsx.hbs +9 -0
- package/templates/classroom/app/globals.css.hbs +87 -0
- package/templates/classroom/app/layout.tsx.hbs +41 -0
- package/templates/classroom/app/page.tsx.hbs +103 -0
- package/templates/classroom/app/projects/[id]/feedback/page.tsx.hbs +159 -0
- package/templates/classroom/app/projects/[id]/present/page.tsx.hbs +113 -0
- package/templates/classroom/next.config.ts.hbs +8 -0
- package/templates/classroom/postcss.config.mjs.hbs +14 -0
- package/templates/classroom/proxy.ts.hbs +10 -0
- package/templates/classroom/tsconfig.json.hbs +21 -0
- package/templates/content/app/(auth)/sign-in/page.tsx.hbs +9 -0
- package/templates/content/app/(auth)/sign-up/page.tsx.hbs +9 -0
- package/templates/content/app/globals.css.hbs +87 -0
- package/templates/content/app/layout.tsx.hbs +41 -0
- package/templates/content/app/newsletter/page.tsx.hbs +90 -0
- package/templates/content/app/page.tsx.hbs +105 -0
- package/templates/content/app/posts/[slug]/page.tsx.hbs +119 -0
- package/templates/content/next.config.ts.hbs +8 -0
- package/templates/content/postcss.config.mjs.hbs +14 -0
- package/templates/content/proxy.ts.hbs +10 -0
- package/templates/content/tsconfig.json.hbs +21 -0
- package/templates/dashboard/app/(auth)/sign-in/page.tsx.hbs +9 -0
- package/templates/dashboard/app/(auth)/sign-up/page.tsx.hbs +9 -0
- package/templates/dashboard/app/admin/data/[entity]/page.tsx.hbs +68 -0
- package/templates/dashboard/app/admin/page.tsx.hbs +59 -0
- package/templates/dashboard/app/globals.css.hbs +87 -0
- package/templates/dashboard/app/layout.tsx.hbs +41 -0
- package/templates/dashboard/app/page.tsx.hbs +57 -0
- package/templates/dashboard/next.config.ts.hbs +8 -0
- package/templates/dashboard/postcss.config.mjs.hbs +14 -0
- package/templates/dashboard/proxy.ts.hbs +10 -0
- package/templates/dashboard/src/lib/db.ts.hbs +39 -0
- package/templates/dashboard/tsconfig.json.hbs +21 -0
- package/templates/fullstack/apps-api-express/.env.example.hbs +6 -0
- package/templates/fullstack/apps-api-express/.env.local.hbs +6 -0
- package/templates/fullstack/apps-api-express/package.json.hbs +24 -0
- package/templates/fullstack/apps-api-express/src/index.ts.hbs +41 -0
- package/templates/fullstack/apps-api-express/src/routes/health.ts.hbs +11 -0
- package/templates/fullstack/apps-api-express/src/routes/users.ts.hbs +43 -0
- package/templates/fullstack/apps-api-express/tsconfig.json.hbs +16 -0
- package/templates/fullstack/apps-api-fastify/.env.example.hbs +6 -0
- package/templates/fullstack/apps-api-fastify/.env.local.hbs +6 -0
- package/templates/fullstack/apps-api-fastify/package.json.hbs +22 -0
- package/templates/fullstack/apps-api-fastify/src/index.ts.hbs +28 -0
- package/templates/fullstack/apps-api-fastify/src/routes/health.ts.hbs +11 -0
- package/templates/fullstack/apps-api-fastify/src/routes/users.ts.hbs +43 -0
- package/templates/fullstack/apps-api-fastify/tsconfig.json.hbs +16 -0
- package/templates/fullstack/apps-api-hono/.env.example.hbs +6 -0
- package/templates/fullstack/apps-api-hono/.env.local.hbs +6 -0
- package/templates/fullstack/apps-api-hono/package.json.hbs +22 -0
- package/templates/fullstack/apps-api-hono/src/index.ts.hbs +35 -0
- package/templates/fullstack/apps-api-hono/src/routes/health.ts.hbs +11 -0
- package/templates/fullstack/apps-api-hono/src/routes/users.ts.hbs +43 -0
- package/templates/fullstack/apps-api-hono/tsconfig.json.hbs +16 -0
- package/templates/fullstack/apps-web-nextjs/.env.example.hbs +5 -0
- package/templates/fullstack/apps-web-nextjs/.env.local.hbs +5 -0
- package/templates/fullstack/apps-web-nextjs/app/(auth)/forgot-password/page.tsx.hbs +11 -0
- package/templates/fullstack/apps-web-nextjs/app/(auth)/reset-password/page.tsx.hbs +39 -0
- package/templates/fullstack/apps-web-nextjs/app/(auth)/sign-in/page.tsx.hbs +9 -0
- package/templates/fullstack/apps-web-nextjs/app/(auth)/sign-up/page.tsx.hbs +9 -0
- package/templates/fullstack/apps-web-nextjs/app/(auth)/verify-email/page.tsx.hbs +11 -0
- package/templates/fullstack/apps-web-nextjs/app/dashboard/layout.tsx.hbs +15 -0
- package/templates/fullstack/apps-web-nextjs/app/dashboard/page.tsx.hbs +27 -0
- package/templates/fullstack/apps-web-nextjs/app/globals.css.hbs +21 -0
- package/templates/fullstack/apps-web-nextjs/app/layout.tsx.hbs +30 -0
- package/templates/fullstack/apps-web-nextjs/app/page.tsx.hbs +17 -0
- package/templates/fullstack/apps-web-nextjs/next.config.ts.hbs +16 -0
- package/templates/fullstack/apps-web-nextjs/package.json.hbs +34 -0
- package/templates/fullstack/apps-web-nextjs/postcss.config.mjs.hbs +9 -0
- package/templates/fullstack/apps-web-nextjs/tsconfig.json.hbs +21 -0
- package/templates/fullstack/root/.gitignore.hbs +42 -0
- package/templates/fullstack/root/githat.yaml.hbs +17 -0
- package/templates/fullstack/root/package.json.hbs +15 -0
- package/templates/fullstack/root/turbo.json.hbs +20 -0
- package/templates/marketplace/CULTURE.md +74 -0
- package/templates/marketplace/app/(auth)/sign-in/page.tsx.hbs +9 -0
- package/templates/marketplace/app/(auth)/sign-up/page.tsx.hbs +9 -0
- package/templates/marketplace/app/(shop)/[slug]/p/[productId]/page.tsx.hbs +99 -0
- package/templates/marketplace/app/(shop)/[slug]/page.tsx.hbs +90 -0
- package/templates/marketplace/app/admin/page.tsx.hbs +95 -0
- package/templates/marketplace/app/cart/page.tsx.hbs +157 -0
- package/templates/marketplace/app/globals.css.hbs +87 -0
- package/templates/marketplace/app/layout.tsx.hbs +77 -0
- package/templates/marketplace/app/page.tsx.hbs +178 -0
- package/templates/marketplace/app/sell/page.tsx.hbs +78 -0
- package/templates/marketplace/next.config.ts.hbs +8 -0
- package/templates/marketplace/postcss.config.mjs.hbs +14 -0
- package/templates/marketplace/proxy.ts.hbs +10 -0
- package/templates/marketplace/src/lib/anon-session.ts.hbs +117 -0
- package/templates/marketplace/src/lib/categories.ts.hbs +35 -0
- package/templates/marketplace/tsconfig.json.hbs +21 -0
- package/templates/nextjs/.github/workflows/deploy.yml.hbs +107 -0
- package/templates/nextjs/app/(auth)/reset-password/page.tsx.hbs +106 -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 +5 -2
- package/templates/nextjs/proxy.ts.hbs +10 -0
- package/templates/plain/app/(auth)/sign-in/page.tsx.hbs +9 -0
- package/templates/plain/app/(auth)/sign-up/page.tsx.hbs +9 -0
- package/templates/plain/app/globals.css.hbs +87 -0
- package/templates/plain/app/layout.tsx.hbs +41 -0
- package/templates/plain/app/page.tsx.hbs +123 -0
- package/templates/plain/next.config.ts.hbs +8 -0
- package/templates/plain/postcss.config.mjs.hbs +14 -0
- package/templates/plain/proxy.ts.hbs +10 -0
- package/templates/plain/tsconfig.json.hbs +21 -0
- package/templates/portfolio/app/(auth)/sign-in/page.tsx.hbs +9 -0
- package/templates/portfolio/app/(auth)/sign-up/page.tsx.hbs +9 -0
- package/templates/portfolio/app/globals.css.hbs +87 -0
- package/templates/portfolio/app/layout.tsx.hbs +41 -0
- package/templates/portfolio/app/page.tsx.hbs +86 -0
- package/templates/portfolio/next.config.ts.hbs +8 -0
- package/templates/portfolio/postcss.config.mjs.hbs +14 -0
- package/templates/portfolio/proxy.ts.hbs +10 -0
- package/templates/portfolio/tsconfig.json.hbs +21 -0
- 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/templates/saas/app/(auth)/sign-in/page.tsx.hbs +9 -0
- package/templates/saas/app/(auth)/sign-up/page.tsx.hbs +9 -0
- package/templates/saas/app/admin/billing/page.tsx.hbs +145 -0
- package/templates/saas/app/admin/page.tsx.hbs +106 -0
- package/templates/saas/app/admin/team/page.tsx.hbs +134 -0
- package/templates/saas/app/globals.css.hbs +87 -0
- package/templates/saas/app/layout.tsx.hbs +41 -0
- package/templates/saas/app/page.tsx.hbs +108 -0
- package/templates/saas/app/pricing/page.tsx.hbs +131 -0
- package/templates/saas/next.config.ts.hbs +8 -0
- package/templates/saas/postcss.config.mjs.hbs +14 -0
- package/templates/saas/proxy.ts.hbs +10 -0
- package/templates/saas/tsconfig.json.hbs +21 -0
- package/templates/nextjs/middleware.ts.hbs +0 -10
package/README.md
CHANGED
|
@@ -1,8 +1,22 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
1
3
|
# create-githat-app
|
|
2
4
|
|
|
3
|
-
|
|
5
|
+
**The CLI for [GitHat](https://githat.io) — Auth + Hosting that replaces Clerk + Vercel**
|
|
6
|
+
|
|
7
|
+
[](https://www.npmjs.com/package/create-githat-app)
|
|
8
|
+
[](https://www.npmjs.com/package/create-githat-app)
|
|
9
|
+
[](https://www.npmjs.com/package/@githat/nextjs)
|
|
10
|
+
[](https://githat.io)
|
|
11
|
+
[](LICENSE)
|
|
12
|
+
|
|
13
|
+
</div>
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
Scaffold a production-ready app with a fully-managed backend — auth, teams, orgs, API keys, and AI agent identity. **No backend to deploy.**
|
|
4
18
|
|
|
5
|
-
[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.
|
|
6
20
|
|
|
7
21
|
## Install & Launch
|
|
8
22
|
|
|
@@ -61,7 +75,6 @@ The CLI asks you a series of questions:
|
|
|
61
75
|
│ ◻ Forgot password
|
|
62
76
|
│ ◻ Email verification
|
|
63
77
|
│ ◻ Organization management
|
|
64
|
-
│ ◻ MCP server identity
|
|
65
78
|
│ ◻ AI agent identity
|
|
66
79
|
│
|
|
67
80
|
◆ Database?
|
|
@@ -132,11 +145,11 @@ npx create-githat-app --version
|
|
|
132
145
|
|
|
133
146
|
A production-ready project connected to GitHat's hosted backend:
|
|
134
147
|
|
|
135
|
-
- **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
|
|
136
149
|
- **Auth pages** — sign-in, sign-up, forgot password, email verification
|
|
137
150
|
- **Protected dashboard** — sidebar navigation, org switcher, user button
|
|
138
151
|
- **`@githat/nextjs` SDK** — `<GitHatProvider>`, `<ProtectedRoute>`, `useAuth()`
|
|
139
|
-
- **`githat/` platform folder** — typed API client for
|
|
152
|
+
- **`githat/` platform folder** — typed API client for the full REST API
|
|
140
153
|
- **Dark theme** — zinc/purple design system out of the box
|
|
141
154
|
- **Database ready** — Prisma or Drizzle for your app's own data (optional)
|
|
142
155
|
- **Tailwind CSS 4** — utility-first styling (optional)
|
|
@@ -154,7 +167,6 @@ githat/
|
|
|
154
167
|
auth.ts # Login, register, forgot password, verify email
|
|
155
168
|
orgs.ts # Create/update orgs, invite/remove members
|
|
156
169
|
users.ts # List orgs, switch org
|
|
157
|
-
mcp.ts # Register/verify MCP servers
|
|
158
170
|
agents.ts # Register/verify AI agent wallets
|
|
159
171
|
auth/
|
|
160
172
|
guard.tsx # Role-based route protection component
|
|
@@ -165,7 +177,6 @@ githat/
|
|
|
165
177
|
apps.tsx # App + API key management
|
|
166
178
|
members.tsx # Invite members, manage roles, remove
|
|
167
179
|
settings.tsx # Edit org name, brand color, save
|
|
168
|
-
mcp-servers.tsx # Register MCP servers, verify, remove
|
|
169
180
|
agents.tsx # Register AI agent wallets, verify, remove
|
|
170
181
|
```
|
|
171
182
|
|
|
@@ -179,23 +190,21 @@ You don't deploy or maintain a backend. GitHat's hosted platform handles:
|
|
|
179
190
|
- **Organizations** — create, switch, branding, custom domains
|
|
180
191
|
- **Team management** — invite members by email, assign roles (owner/admin/member), remove
|
|
181
192
|
- **API key management** — publishable + secret keys per app, rotation
|
|
182
|
-
- **MCP server registration** — domain verification via DNS TXT, OAuth2 credentials
|
|
183
193
|
- **AI agent registration** — Ethereum wallet verification, challenge-response tokens
|
|
184
194
|
- **Email delivery** — verification emails, invitations, password resets (via AWS SES)
|
|
185
|
-
- **Database** — users, orgs, teams, apps, agents
|
|
186
|
-
- **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/`
|
|
187
197
|
|
|
188
198
|
Your data lives in GitHat's infrastructure. You write frontend code, GitHat handles the rest.
|
|
189
199
|
|
|
190
|
-
##
|
|
200
|
+
## Two Identity Types
|
|
191
201
|
|
|
192
|
-
GitHat supports
|
|
202
|
+
GitHat supports two types of identity in a single platform:
|
|
193
203
|
|
|
194
|
-
| Type
|
|
195
|
-
|
|
|
196
|
-
| **Humans**
|
|
197
|
-
| **
|
|
198
|
-
| **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 |
|
|
199
208
|
|
|
200
209
|
## Project Structure
|
|
201
210
|
|
|
@@ -263,6 +272,19 @@ VITE_GITHAT_PUBLISHABLE_KEY=pk_live_...
|
|
|
263
272
|
VITE_GITHAT_API_URL=https://api.githat.io
|
|
264
273
|
```
|
|
265
274
|
|
|
275
|
+
## Documentation
|
|
276
|
+
|
|
277
|
+
- [GitHat Quick Start](https://githat.io/docs/quickstart) — Get running in 5 minutes
|
|
278
|
+
- [SDK Reference](https://githat.io/docs/sdk) — `@githat/nextjs` hooks, components, and server utils
|
|
279
|
+
- [API Reference](https://githat.io/docs/api) — Full REST API reference
|
|
280
|
+
- [CLI Reference](https://githat.io/docs/cli) — Flags, prompts, and templates
|
|
281
|
+
- [Next.js Guide](https://githat.io/docs/nextjs) — Auth in Next.js 14-16+
|
|
282
|
+
- [React Guide](https://githat.io/docs/react) — Auth in any React app
|
|
283
|
+
- [Bring Your Own Database](https://githat.io/docs/byod) — Keep your PostgreSQL, MySQL, or MongoDB
|
|
284
|
+
- [MCP Servers](https://githat.io/docs/mcp) — Domain verification for AI tool servers
|
|
285
|
+
- [AI Agents](https://githat.io/docs/agents) — Wallet-based identity for autonomous agents
|
|
286
|
+
- [Skills Marketplace](https://githat.io/docs/skills) — Install templates, integrations, and workflows
|
|
287
|
+
|
|
266
288
|
## Contributing
|
|
267
289
|
|
|
268
290
|
```bash
|
|
@@ -273,6 +295,14 @@ npm run build
|
|
|
273
295
|
node bin/index.js test-app
|
|
274
296
|
```
|
|
275
297
|
|
|
298
|
+
## Related
|
|
299
|
+
|
|
300
|
+
- [@githat/nextjs](https://www.npmjs.com/package/@githat/nextjs) — React/Next.js SDK
|
|
301
|
+
- [GitHat Platform](https://githat.io) — Auth + Hosting replacing Clerk + Vercel
|
|
302
|
+
- [GitHat Pricing](https://githat.io/pricing) — Free, Pro, and Enterprise tiers
|
|
303
|
+
- [GitHat vs Clerk](https://githat.io/compare/githat-vs-clerk) — Feature comparison
|
|
304
|
+
- [GitHat vs Auth0](https://githat.io/compare/githat-vs-auth0) — Why developers switch
|
|
305
|
+
|
|
276
306
|
## License
|
|
277
307
|
|
|
278
|
-
|
|
308
|
+
Proprietary — see [LICENSE](LICENSE)
|