Skip to content

Commit bed92df

Browse files
auge2uclaude
andcommitted
feat: Platform4Sync v0.1.0 — skills marketplace for multi-tenant SaaS
4 Claude Code skills, 3 scaffold templates, shared contracts, and validators for building multi-tenant SaaS on Cloudflare Workers + Neon PostgreSQL. Skills: - multi-tenant-platform: 3-tier architecture (Platform/Partner/Customer) - graduated-auth: Anonymous → Preview → OAuth → Full Account - neon-multi-tenant: Neon branches, Hyperdrive, Drizzle ORM - theme-inspired-tokens: Culturally-grounded W3C DTCG design tokens Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent c45c1c5 commit bed92df

13 files changed

Lines changed: 95 additions & 451 deletions

File tree

.github/release-strategy.md

Lines changed: 0 additions & 167 deletions
This file was deleted.

.github/repository-metadata.yml

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# GitHub Repository Metadata
2-
# Apply via: gh repo edit syncupsuite/hn-platform4sync [flags]
2+
# Apply via: gh repo edit syncupsuite/webplatform4sync [flags]
33
# Or manually in GitHub Settings > General
44

5-
description: "Internal platform standards, skills, and scaffold templates for SyncUpSuite multi-tenant SaaS projects"
5+
description: "Platform standards, skills, and scaffold templates for SyncUpSuite multi-tenant SaaS projects"
66

77
topics:
88
- claude-code-skills
@@ -23,8 +23,7 @@ topics:
2323

2424
homepage: ""
2525

26-
# Visibility: private (internal repo)
27-
# Public counterpart: syncupsuite/webplatform4sync
26+
# Visibility: public
2827

2928
features:
3029
wiki: false

CLAUDE.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,11 @@
1-
# CLAUDE.md — hn-platform4sync
1+
# CLAUDE.md — webplatform4sync
22

33
## Repository Purpose
44

55
Internal platform standards, skills, and scaffold templates for all SyncUpSuite projects. This repo defines **the standard** that every project — greenfield or brownfield — aligns to.
66

77
**Org**: `syncupsuite`
8-
**Prefix**: `hn-` = internal
9-
**Public counterpart**: [`syncupsuite/webplatform4sync`](https://github.com/syncupsuite/webplatform4sync)
8+
****Repo**: `syncupsuite/webplatform4sync`
109

1110
---
1211

LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2026 SyncUpSuite
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

README.md

Lines changed: 56 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,56 @@
1-
# hn-platform4sync
2-
Internal platform standards, skills, and scaffold templates for SyncUpSuite projects
1+
# Platform4Sync
2+
3+
Platform standards, skills, and scaffold templates for building multi-tenant SaaS applications on Cloudflare Workers + Neon PostgreSQL.
4+
5+
## Install as Claude Code Marketplace
6+
7+
Add to your project's `.claude/settings.json`:
8+
9+
```json
10+
{
11+
"extraKnownMarketplaces": {
12+
"webplatform4sync": {
13+
"source": {
14+
"source": "github",
15+
"repo": "syncupsuite/webplatform4sync"
16+
}
17+
}
18+
}
19+
}
20+
```
21+
22+
## What's Inside
23+
24+
- **Skills** — Claude Code skills for multi-tenant architecture, graduated auth, Neon isolation, and design tokens
25+
- **Scaffolds** — Project templates for greenfield, brownfield, and overlay adoption
26+
- **Contracts** — Shared type definitions ensuring cross-skill compatibility
27+
- **Validators** — Token and tenant configuration validators
28+
29+
## Documentation
30+
31+
- [What is Platform4Sync?](docs/what-is-platform4sync.md) — Overview and technical architecture
32+
- [Architecture Rationale](docs/rationale.md) — Design decisions and review history
33+
- [Contributing](docs/contributing.md) — How to add skills and templates
34+
35+
## Skills
36+
37+
Each skill has a `skill.md` entry point. Point Claude Code at the skill directory and describe your task:
38+
39+
| Skill | Purpose |
40+
|-------|---------|
41+
| `skills/multi-tenant-platform/` | 3-tier tenant architecture (Platform/Partner/Customer) |
42+
| `skills/graduated-auth/` | Anonymous → Preview → OAuth → Full Account |
43+
| `skills/neon-multi-tenant/` | Neon branches, Hyperdrive, Drizzle ORM |
44+
| `skills/theme-inspired-tokens/` | Culturally-grounded design tokens (W3C DTCG) |
45+
46+
## Scaffolds
47+
48+
| Template | When to Use |
49+
|----------|-------------|
50+
| `scaffold/greenfield/` | New project from scratch |
51+
| `scaffold/brownfield/` | Migrating existing project to standards |
52+
| `scaffold/overlay/` | Adding design token system only |
53+
54+
## License
55+
56+
MIT

docs/for-syncup.md

Lines changed: 0 additions & 64 deletions
This file was deleted.

scaffold/greenfield/scaffold.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -126,8 +126,8 @@ The following placeholders are replaced during scaffolding:
126126
| `{{REPO_NAME}}` | Question 1 | `su-brandsyncup-com` |
127127
| `{{SCHEMA_NAME}}` | Question 1 | `brandsyncup` |
128128
| `{{NEON_REGION}}` | Question 3 | `europe-west6` or `us-east-2` |
129-
| `{{CF_ACCOUNT_ID}}` | Cloudflare auth | `6b078bcaa9984a2d1dbe483e65c741b0` |
130-
| `{{NEON_PROJECT_ID}}` | Neon project | `polished-truth-90679079` |
129+
| `{{CF_ACCOUNT_ID}}` | Cloudflare auth | `your-cloudflare-account-id` |
130+
| `{{NEON_PROJECT_ID}}` | Neon project | `your-neon-project-id` |
131131

132132
---
133133

0 commit comments

Comments
 (0)