Skip to content

Commit f23655b

Browse files
committed
docs+site: sweep — MIT, nav cleanup, hero slot, Sequoia install hint
- License: Apache-2.0 → MIT across config.ts description/OG/Twitter/FAQ JSON-LD/footer (EN + zh). - Nav: drop the redundant 'GitHub' text link (already covered by the socialLinks github icon) and remove the twitter socialLink entirely (no account yet, it was rendering an empty button). - Homepage: move the product-hero screenshot from inline markdown to the Layout.vue #home-hero-after slot, so it sits between the VitePress hero and the features grid (it was stuck below the 12 feature cards). - SoftwareVersion JSON-LD now reads from the root package.json at build time instead of the hardcoded '0.1.1' (was stale vs. the 0.1.2 release). SmartDownload already reads from pkg.version, so both paths track the release. - macOS Sequoia 15+ install hint: right-click → Open no longer bypasses Gatekeeper and 'Open Anyway' often fails. README (EN + zh) and the SmartDownload hint now surface the reliable 'xattr -cr' one-liner. - productName: 'open-codesign' → 'Open CoDesign' so the installed .app bundle and DMG window use the branded name. artifactName patterns are pinned to the slug so filenames stay hyphenated ASCII. - Comparison table: display: table + table-layout: fixed, fixes the empty strip on the right half on wide viewports.
1 parent 501f956 commit f23655b

10 files changed

Lines changed: 70 additions & 29 deletions

File tree

README.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -138,7 +138,14 @@ Each release ships with `SHA256SUMS.txt` and a CycloneDX SBOM (`*-sbom.cdx.json`
138138
Each release-time PR is auto-opened by CI once the corresponding tap, manifest, or secret is provisioned. See each `packaging/*/README.md` for setup.
139139
</details>
140140

141-
> **v0.1 note:** installers are unsigned. macOS: right-click → Open, or run `xattr -d com.apple.quarantine /Applications/open-codesign.app` after install. Windows: SmartScreen → More info → Run anyway.
141+
> **v0.1 note:** installers are unsigned. On **macOS Sequoia 15+** right-click → Open no longer bypasses Gatekeeper, and "Open Anyway" in System Settings often fails. Reliable one-liner:
142+
>
143+
> ```sh
144+
> xattr -cr "/Applications/Open CoDesign.app"
145+
> ```
146+
>
147+
> Then double-click normally. (Older 0.1.x builds are installed as `/Applications/open-codesign.app`.)
148+
> On **Windows**: SmartScreen → More info → Run anyway.
142149
>
143150
> Want a verified build? Compile from source — see [CONTRIBUTING.md](./CONTRIBUTING.md).
144151

README.zh-CN.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -138,9 +138,16 @@ Open CoDesign 可以把一句自然语言提示词,直接变成一个完成度
138138
一旦对应的 tap、manifest 或 secret 准备好,CI 会自动为 release 打开对应 PR。详细说明见各个 `packaging/*/README.md`
139139
</details>
140140

141-
> **v0.1 提示:** 当前安装包还没有签名。macOS 可以右键 → 打开,或者安装后执行 `xattr -d com.apple.quarantine /Applications/open-codesign.app`。Windows 可以在 SmartScreen 中点击 “More info” → “Run anyway”。
141+
> **v0.1 提示:** 当前安装包未签名。**macOS Sequoia 15+** 起,右键 → 打开 已不能绕过 Gatekeeper,即使在「系统设置 → 隐私与安全性」里点"仍要打开"也经常失败。最可靠的一行命令:
142142
>
143-
> 如果你更在意可验证构建,也可以自己从源码编译,见 [CONTRIBUTING.md](./CONTRIBUTING.md)
143+
> ```sh
144+
> xattr -cr "/Applications/Open CoDesign.app"
145+
> ```
146+
>
147+
> 跑完直接双击打开即可。(0.1.x 旧版本装完后路径是 `/Applications/open-codesign.app`。)
148+
> **Windows**:SmartScreen → More info → Run anyway。
149+
>
150+
> 想要可验证构建可以自己从源码编译,见 [CONTRIBUTING.md](./CONTRIBUTING.md)。
144151
145152
### 2. 添加 API Key
146153

apps/desktop/electron-builder.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
appId: ai.opencowork.codesign
2-
productName: open-codesign
2+
productName: Open CoDesign
33
# Declare the publish target explicitly so electron-builder's updater-info
44
# machinery (channels, provider, latest.yml) has something non-null to hang
55
# on — otherwise NSIS packaging crashes with "Cannot read properties of null
@@ -22,7 +22,7 @@ mac:
2222
hardenedRuntime: true
2323
gatekeeperAssess: false
2424
notarize: false
25-
artifactName: ${productName}-${version}-${arch}.${ext}
25+
artifactName: open-codesign-${version}-${arch}.${ext}
2626
target:
2727
- target: dmg
2828
arch: [arm64, x64]
@@ -48,7 +48,7 @@ dmg:
4848
path: /Applications
4949
win:
5050
icon: resources/icon.ico
51-
artifactName: ${productName}-${version}-${arch}-setup.${ext}
51+
artifactName: open-codesign-${version}-${arch}-setup.${ext}
5252
target:
5353
- target: nsis
5454
arch: [x64, arm64]
@@ -62,7 +62,7 @@ linux:
6262
# rpm → x86_64). SmartDownload.vue + Homebrew cask + Flatpak manifest all
6363
# reference `-x64.ext`; picking a fixed literal keeps them in sync. We
6464
# only ship one Linux arch, so this is safe until we add arm64.
65-
artifactName: ${productName}-${version}-x64.${ext}
65+
artifactName: open-codesign-${version}-x64.${ext}
6666
target:
6767
- target: AppImage
6868
arch: [x64]

website/.vitepress/config.ts

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,18 @@
11
import tailwindcss from '@tailwindcss/vite';
22
import { defineConfig } from 'vitepress';
3+
import rootPkg from '../../package.json' with { type: 'json' };
34

45
const SITE_ORIGIN = 'https://opencoworkai.github.io';
56
const SITE_BASE = '/open-codesign/';
67
const SITE_URL = `${SITE_ORIGIN}${SITE_BASE}`;
78
const OG_IMAGE = `${SITE_URL}og.svg`;
9+
const SOFTWARE_VERSION = (rootPkg as { version: string }).version;
810

911
export default defineConfig({
1012
title: 'Open CoDesign',
1113
titleTemplate: ':title — Open CoDesign',
1214
description:
13-
'Open-source desktop AI design tool — the self-hosted alternative to Claude Design. Multi-model BYOK (Anthropic, OpenAI, Gemini, DeepSeek, Ollama), local-first, Apache-2.0.',
15+
'Open-source desktop AI design tool — the self-hosted alternative to Claude Design. Multi-model BYOK (Anthropic, OpenAI, Gemini, DeepSeek, Ollama), local-first, MIT.',
1416
lang: 'en-US',
1517

1618
base: SITE_BASE,
@@ -33,7 +35,7 @@ export default defineConfig({
3335
{
3436
property: 'og:description',
3537
content:
36-
'Open-source desktop AI design tool. A self-hosted alternative to Claude Design. Prompt to prototype, slide deck, or marketing asset. Multi-model BYOK, local-first, Apache-2.0.',
38+
'Open-source desktop AI design tool. A self-hosted alternative to Claude Design. Prompt to prototype, slide deck, or marketing asset. Multi-model BYOK, local-first, MIT.',
3739
},
3840
],
3941
['meta', { property: 'og:image', content: OG_IMAGE }],
@@ -49,7 +51,7 @@ export default defineConfig({
4951
{
5052
name: 'twitter:description',
5153
content:
52-
'Open-source desktop AI design tool. BYOK, local-first, Apache-2.0. Runs on your laptop.',
54+
'Open-source desktop AI design tool. BYOK, local-first, MIT. Runs on your laptop.',
5355
},
5456
],
5557
['meta', { name: 'twitter:image', content: OG_IMAGE }],
@@ -81,7 +83,7 @@ export default defineConfig({
8183
url: SITE_URL,
8284
applicationCategory: 'DesignApplication',
8385
operatingSystem: 'macOS, Windows, Linux',
84-
softwareVersion: '0.1.1',
86+
softwareVersion: SOFTWARE_VERSION,
8587
releaseNotes: `${SITE_URL}#whats-working-today`,
8688
downloadUrl: 'https://github.com/OpenCoworkAI/open-codesign/releases',
8789
offers: {
@@ -90,7 +92,7 @@ export default defineConfig({
9092
priceCurrency: 'USD',
9193
description: 'Free and open source. Bring your own API key (token cost only).',
9294
},
93-
license: 'https://www.apache.org/licenses/LICENSE-2.0',
95+
license: 'https://opensource.org/licenses/MIT',
9496
codeRepository: 'https://github.com/OpenCoworkAI/open-codesign',
9597
author: {
9698
'@type': 'Organization',
@@ -122,7 +124,7 @@ export default defineConfig({
122124
name: 'Is Open CoDesign free?',
123125
acceptedAnswer: {
124126
'@type': 'Answer',
125-
text: 'Yes. Open CoDesign is Apache-2.0 licensed and free to download and use. You bring your own API key for any supported model provider and pay only the token cost to that provider. There is no subscription, no cloud account, and no per-token surcharge from us.',
127+
text: 'Yes. Open CoDesign is MIT licensed and free to download and use. You bring your own API key for any supported model provider and pay only the token cost to that provider. There is no subscription, no cloud account, and no per-token surcharge from us.',
126128
},
127129
},
128130
{
@@ -198,7 +200,6 @@ export default defineConfig({
198200
text: 'Changelog',
199201
link: 'https://github.com/OpenCoworkAI/open-codesign/blob/main/CHANGELOG.md',
200202
},
201-
{ text: 'GitHub', link: 'https://github.com/OpenCoworkAI/open-codesign' },
202203
],
203204

204205
sidebar: [
@@ -225,12 +226,11 @@ export default defineConfig({
225226

226227
socialLinks: [
227228
{ icon: 'github', link: 'https://github.com/OpenCoworkAI/open-codesign' },
228-
{ icon: 'twitter', link: 'https://twitter.com/OpenCoworkAI' },
229229
],
230230

231231
footer: {
232232
message:
233-
'Released under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache-2.0 License</a>. · <a href="https://github.com/OpenCoworkAI/open-codesign/blob/main/CONTRIBUTING.md">Contribute</a> · <a href="https://github.com/OpenCoworkAI/open-codesign/issues">Issues</a>',
233+
'Released under the <a href="https://opensource.org/licenses/MIT">MIT License</a>. · <a href="https://github.com/OpenCoworkAI/open-codesign/blob/main/CONTRIBUTING.md">Contribute</a> · <a href="https://github.com/OpenCoworkAI/open-codesign/issues">Issues</a>',
234234
copyright: '© 2026-present OpenCoworkAI',
235235
},
236236
},
@@ -245,7 +245,7 @@ export default defineConfig({
245245
lang: 'zh-CN',
246246
title: 'Open CoDesign',
247247
description:
248-
'开源桌面 AI 设计工具——Claude Design 的自托管替代方案。自带 API Key(Anthropic、OpenAI、Gemini、DeepSeek、Ollama),100% 本地运行,Apache-2.0。',
248+
'开源桌面 AI 设计工具——Claude Design 的自托管替代方案。自带 API Key(Anthropic、OpenAI、Gemini、DeepSeek、Ollama),100% 本地运行,MIT。',
249249
themeConfig: {
250250
nav: [
251251
{ text: '首页', link: '/zh/' },
@@ -264,7 +264,7 @@ export default defineConfig({
264264
},
265265
],
266266
footer: {
267-
message: '基于 Apache-2.0 协议开源。',
267+
message: '基于 MIT 协议开源。',
268268
copyright: '© 2026-present OpenCoworkAI',
269269
},
270270
},
Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
<script setup lang="ts">
2+
import DefaultTheme from 'vitepress/theme';
3+
import { useData, withBase } from 'vitepress';
4+
5+
const { Layout } = DefaultTheme;
6+
const { frontmatter } = useData();
7+
</script>
8+
9+
<template>
10+
<Layout>
11+
<template #home-hero-after>
12+
<div v-if="frontmatter.layout === 'home'" class="codesign-hero-shot">
13+
<img
14+
:src="withBase('/screenshots/product-hero.png')"
15+
alt="Open CoDesign — chat on the left, live artifact on the right"
16+
/>
17+
</div>
18+
</template>
19+
</Layout>
20+
</template>

website/.vitepress/theme/SmartDownload.vue

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -136,8 +136,9 @@ const secondaryAssets = () => {
136136
</details>
137137

138138
<p class="install-hint">
139-
macOS 安装提示:<strong>务必先拖到「应用程序」文件夹再启动</strong>——
140-
直接从 DMG 双击运行会让系统钥匙串不可用。首次启动右键 → 打开(避开 Gatekeeper 拦截)。
139+
<strong>macOS 安装</strong>:拖到「应用程序」。双击打开若被 Gatekeeper 拦截(常见于 Sequoia 15+),终端跑一次:<br/>
140+
<code>xattr -cr "/Applications/Open CoDesign.app"</code><br/>
141+
然后再双击就能打开。下载历史版本(文件名仍是 <code>open-codesign.app</code>)请把路径对应替换。
141142
</p>
142143
</div>
143144
</template>
@@ -254,10 +255,20 @@ const secondaryAssets = () => {
254255
border-left: 3px solid var(--vp-c-brand-1, #c96442);
255256
background: rgba(201, 100, 66, 0.05);
256257
font-size: 0.82rem;
257-
line-height: 1.5;
258+
line-height: 1.6;
258259
color: var(--vp-c-text-2, #6b6b6b);
259260
border-radius: 0 6px 6px 0;
260261
}
262+
.install-hint code {
263+
display: inline-block;
264+
padding: 0.1rem 0.4rem;
265+
margin: 0.2rem 0;
266+
background: rgba(0, 0, 0, 0.06);
267+
border-radius: 4px;
268+
font-size: 0.78rem;
269+
font-family: var(--vp-font-family-mono);
270+
color: var(--vp-c-text-1, #1a1a1a);
271+
}
261272
.install-hint strong {
262273
color: var(--vp-c-text-1, #1a1a1a);
263274
}

website/.vitepress/theme/index.ts

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,12 @@
11
import DefaultTheme from 'vitepress/theme';
22
import DemoVideo from './DemoVideo.vue';
3+
import Layout from './Layout.vue';
34
import SmartDownload from './SmartDownload.vue';
45
import './style.css';
56

67
export default {
78
extends: DefaultTheme,
9+
Layout,
810
enhanceApp({ app }: { app: import('vue').App }) {
911
app.component('SmartDownload', SmartDownload);
1012
app.component('DemoVideo', DemoVideo);

website/.vitepress/theme/style.css

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -225,6 +225,8 @@ body {
225225
}
226226
.codesign-comparison table {
227227
width: 100%;
228+
display: table;
229+
table-layout: fixed;
228230
border-collapse: collapse;
229231
background: var(--color-surface);
230232
border: 1px solid var(--color-border-muted);

website/index.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -65,10 +65,6 @@ features:
6565
import { withBase } from 'vitepress'
6666
</script>
6767

68-
<div class="codesign-hero-shot">
69-
<img :src="withBase('/screenshots/product-hero.png')" alt="Open CoDesign — prompt on the left, live artifact on the right" />
70-
</div>
71-
7268
<SmartDownload />
7369

7470
<div class="codesign-section">

website/zh/index.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -65,10 +65,6 @@ features:
6565
import { withBase } from 'vitepress'
6666
</script>
6767

68-
<div class="codesign-hero-shot">
69-
<img :src="withBase('/screenshots/product-hero.png')" alt="Open CoDesign — 左侧 chat,右侧 artifact 实时渲染" />
70-
</div>
71-
7268
<SmartDownload />
7369

7470
<div class="codesign-section">

0 commit comments

Comments
 (0)