create-pilotprojects-app 0.1.0 → 0.1.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.
- package/README.md +115 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
# create-pilotprojects-app
|
|
2
|
+
|
|
3
|
+
Scaffold a production-ready monorepo in under a minute — Next.js 15 web app, Expo mobile app, or both, wired together with tRPC, Supabase, Drizzle ORM, and a shared design system.
|
|
4
|
+
|
|
5
|
+
## Usage
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
# npm
|
|
9
|
+
npm create pilotprojects-app@latest
|
|
10
|
+
|
|
11
|
+
# pnpm
|
|
12
|
+
pnpm create pilotprojects-app
|
|
13
|
+
|
|
14
|
+
# yarn
|
|
15
|
+
yarn create pilotprojects-app
|
|
16
|
+
|
|
17
|
+
# With project name pre-filled
|
|
18
|
+
pnpm create pilotprojects-app my-project
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
The CLI is interactive — it asks a few questions then scaffolds, installs dependencies, and runs `git init` automatically.
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## What's included
|
|
26
|
+
|
|
27
|
+
### Core (always scaffolded)
|
|
28
|
+
|
|
29
|
+
| Package | Purpose |
|
|
30
|
+
| --------------------- | ------------------------------------------------------ |
|
|
31
|
+
| `@<scope>/api` | tRPC v11 routers with a feature-based service layer |
|
|
32
|
+
| `@<scope>/db` | Drizzle ORM + Supabase Postgres — migrations included |
|
|
33
|
+
| `@<scope>/auth` | Supabase Auth helpers for web (SSR cookies) and mobile |
|
|
34
|
+
| `@<scope>/validators` | Shared Zod schemas |
|
|
35
|
+
| `@<scope>/config` | Shared ESLint and TypeScript configs |
|
|
36
|
+
|
|
37
|
+
### Apps (your choice)
|
|
38
|
+
|
|
39
|
+
| App | Stack |
|
|
40
|
+
| ------------- | ----------------------------------------------------------------------------- |
|
|
41
|
+
| `apps/web` | Next.js 15 App Router · Tailwind CSS · shadcn/ui · tRPC client (RSC + client) |
|
|
42
|
+
| `apps/mobile` | Expo SDK 52 · React Native · NativeWind · tRPC HTTP client |
|
|
43
|
+
|
|
44
|
+
### Optional add-ons
|
|
45
|
+
|
|
46
|
+
| Feature | What it adds |
|
|
47
|
+
| -------------------- | -------------------------------------------------------------------------------------------- |
|
|
48
|
+
| **Design System** | `@<scope>/ui` — Tailwind preset, shadcn/ui components (web), react-native-reusables (mobile) |
|
|
49
|
+
| **Email** | `@<scope>/email` — Resend SDK + React Email templates |
|
|
50
|
+
| **Sentry** | Error monitoring configured for web and/or mobile |
|
|
51
|
+
| **PostHog** | Product analytics + feature flags |
|
|
52
|
+
| **Google Analytics** | `@next/third-parties` GA4 script in the web layout |
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## Interactive prompts
|
|
57
|
+
|
|
58
|
+
| Prompt | Options | Default |
|
|
59
|
+
| ------------------------------ | ------------------- | ----------------- |
|
|
60
|
+
| Project name | Any lowercase slug | — |
|
|
61
|
+
| Package scope | `@<name>` | `@<project-name>` |
|
|
62
|
+
| Apps to scaffold | Web / Mobile / Both | Both |
|
|
63
|
+
| Include design system? | Yes / No | Yes |
|
|
64
|
+
| Include Sentry? | Yes / No | Yes |
|
|
65
|
+
| Include Resend (email)? | Yes / No | Yes |
|
|
66
|
+
| Include PostHog? | Yes / No | No |
|
|
67
|
+
| Google Analytics? _(web only)_ | Yes / No | No |
|
|
68
|
+
| Package manager | pnpm / npm / yarn | pnpm |
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## After scaffolding
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
cd my-project
|
|
76
|
+
|
|
77
|
+
# Copy and fill in environment files
|
|
78
|
+
cp apps/web/.env.development.example apps/web/.env.development
|
|
79
|
+
# Add: SUPABASE_URL, SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY,
|
|
80
|
+
# DATABASE_URL, RESEND_API_KEY, SENTRY_DSN
|
|
81
|
+
|
|
82
|
+
# Start local Supabase (requires Supabase CLI)
|
|
83
|
+
supabase start
|
|
84
|
+
|
|
85
|
+
# Apply database migrations
|
|
86
|
+
pnpm --filter @repo/db db:migrate
|
|
87
|
+
|
|
88
|
+
# Start dev servers (web + mobile in parallel)
|
|
89
|
+
pnpm dev
|
|
90
|
+
# → web: http://localhost:3000
|
|
91
|
+
# → mobile: Expo DevTools
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## Tech stack
|
|
97
|
+
|
|
98
|
+
| Layer | Choice |
|
|
99
|
+
| ----------- | ----------------------------------- |
|
|
100
|
+
| Monorepo | Turborepo + pnpm workspaces |
|
|
101
|
+
| Web | Next.js 15 (App Router) |
|
|
102
|
+
| Mobile | Expo SDK 52 / React Native 0.76 |
|
|
103
|
+
| API | tRPC v11 + React Query |
|
|
104
|
+
| Database | Drizzle ORM + Supabase Postgres |
|
|
105
|
+
| Auth | Supabase Auth |
|
|
106
|
+
| UI (web) | Tailwind CSS + shadcn/ui |
|
|
107
|
+
| UI (mobile) | NativeWind + react-native-reusables |
|
|
108
|
+
| Email | Resend + React Email |
|
|
109
|
+
| Validation | Zod |
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## License
|
|
114
|
+
|
|
115
|
+
MIT
|