clawnify 0.1.3 → 0.1.4
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 +156 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,156 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<a href="https://clawnify.com">
|
|
3
|
+
<img src="https://clawnify.com/favicon.png" height="64">
|
|
4
|
+
<h3 align="center">Clawnify</h3>
|
|
5
|
+
</a>
|
|
6
|
+
<p align="center">The easiest way to deploy internal software built with Claude Code, Codex, and Cursor.</p>
|
|
7
|
+
</p>
|
|
8
|
+
|
|
9
|
+
## Clawnify CLI
|
|
10
|
+
|
|
11
|
+
Deploy full-stack software with a database to production in seconds. No infrastructure setup, no config files, no Cloudflare account needed.
|
|
12
|
+
|
|
13
|
+
Build with your AI coding tool, deploy with one command, share a live URL. Once you sign in to Clawnify, your team can access all their software and agents from one place — with managed auth across everything.
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
npx clawnify init
|
|
17
|
+
cd my-app
|
|
18
|
+
npx clawnify deploy
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
Your app is live at `https://my-app.apps.clawnify.com` with a D1 database, edge hosting, and a global CDN.
|
|
22
|
+
|
|
23
|
+
## Quick Start
|
|
24
|
+
|
|
25
|
+
### Create a new app
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
npx clawnify init
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Pick a template (blank or CRUD), and you get a ready-to-deploy project:
|
|
32
|
+
|
|
33
|
+
```
|
|
34
|
+
my-app/
|
|
35
|
+
src/
|
|
36
|
+
server/ # Hono API routes + D1 database
|
|
37
|
+
client/ # Preact frontend
|
|
38
|
+
clawnify.json # App manifest
|
|
39
|
+
wrangler.toml # Local dev config
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
### Develop locally
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
cd my-app
|
|
46
|
+
pnpm install
|
|
47
|
+
pnpm dev
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
Opens at `http://localhost:5173` with a local D1 database. Same code, same database interface — no conversion between local and production.
|
|
51
|
+
|
|
52
|
+
### Deploy
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
npx clawnify login
|
|
56
|
+
npx clawnify deploy
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
That's it. Your app is live with:
|
|
60
|
+
- **Edge hosting** on Cloudflare Workers
|
|
61
|
+
- **D1 database** (SQLite at the edge)
|
|
62
|
+
- **Global CDN** for static assets
|
|
63
|
+
- **Custom URL** at `*.apps.clawnify.com`
|
|
64
|
+
|
|
65
|
+
## Install
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
# Run directly (recommended)
|
|
69
|
+
npx clawnify <command>
|
|
70
|
+
|
|
71
|
+
# Or install globally
|
|
72
|
+
npm i -g clawnify
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
## Commands
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
clawnify init [dir] # Scaffold a new app
|
|
79
|
+
clawnify login # Authenticate with Clawnify
|
|
80
|
+
clawnify deploy [dir] # Deploy to production
|
|
81
|
+
clawnify deploy --from owner/repo # Deploy from a GitHub repo
|
|
82
|
+
clawnify ls # List your deployed apps
|
|
83
|
+
clawnify open <slug> # Open app in browser
|
|
84
|
+
clawnify logs <app-id> # View build logs
|
|
85
|
+
clawnify rm <app-id> # Delete an app
|
|
86
|
+
clawnify whoami # Show current user
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
## Deploy from GitHub
|
|
90
|
+
|
|
91
|
+
Any repo with a `clawnify.json` can be deployed:
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
npx clawnify deploy --from clawnify/open-fieldservice
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
### `clawnify.json`
|
|
98
|
+
|
|
99
|
+
Add this to your repo root to make it deployable:
|
|
100
|
+
|
|
101
|
+
```json
|
|
102
|
+
{
|
|
103
|
+
"$schema": "https://app.clawnify.com/schema/v1/clawnify.json",
|
|
104
|
+
"name": "My App",
|
|
105
|
+
"description": "What the app does",
|
|
106
|
+
"app": {
|
|
107
|
+
"framework": "preact+hono",
|
|
108
|
+
"database": true
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
## Claude Code / MCP Integration
|
|
114
|
+
|
|
115
|
+
Use Clawnify as a tool in Claude Code:
|
|
116
|
+
|
|
117
|
+
```bash
|
|
118
|
+
claude mcp add clawnify -- npx clawnify --mcp
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
Then Claude Code can deploy apps directly:
|
|
122
|
+
|
|
123
|
+
```
|
|
124
|
+
> Deploy this app to Clawnify
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
Available MCP tools: `deploy`, `list_apps`, `get_app`, `delete_app`.
|
|
128
|
+
|
|
129
|
+
## How It Works
|
|
130
|
+
|
|
131
|
+
```
|
|
132
|
+
Your code → clawnify deploy → tar.gz upload → build on Cloudflare
|
|
133
|
+
→ D1 database created
|
|
134
|
+
→ Schema applied
|
|
135
|
+
→ Vite builds frontend
|
|
136
|
+
→ Deployed to Workers for Platforms
|
|
137
|
+
→ Live at *.apps.clawnify.com
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
**Local dev** uses `wrangler dev` which runs D1 as local SQLite — identical to production. No conversion, no surprises.
|
|
141
|
+
|
|
142
|
+
## Frameworks
|
|
143
|
+
|
|
144
|
+
| Framework | Stack |
|
|
145
|
+
|-----------|-------|
|
|
146
|
+
| `preact+hono` | Preact frontend + Hono API + D1 |
|
|
147
|
+
| `react+hono` | React frontend + Hono API + D1 |
|
|
148
|
+
| `vite-preact` | Vite + Preact SPA |
|
|
149
|
+
| `static` | Static HTML/CSS/JS |
|
|
150
|
+
|
|
151
|
+
## Links
|
|
152
|
+
|
|
153
|
+
- [Website](https://clawnify.com)
|
|
154
|
+
- [Dashboard](https://app.clawnify.com)
|
|
155
|
+
- [Deploy Button](https://app.clawnify.com/deploy) — one-click deploy for any repo with `clawnify.json`
|
|
156
|
+
- [JSON Schema](https://app.clawnify.com/schema/v1/clawnify.json) — editor autocomplete for `clawnify.json`
|