Perform these operations to scaffold the project. See
references/setup-pattern.md
for exact replacement targets and the
.dev.vars
template.
Clone
the repo and remove
.git
, init fresh repo
Find-replace
vite-flare-starter
with the project name in wrangler.jsonc (worker name, database name, R2 bucket names), package.json (name, database refs), and index.html (title, meta)
Remove
hardcoded
account_id
and replace
database_id
with placeholder in wrangler.jsonc
Reset
package.json version to
0.1.0
Generate
BETTER_AUTH_SECRET
using
openssl rand -hex 32
(or Python
secrets.token_hex(32)
)
Create
.dev.vars
from template (convert kebab-case name to Title Case for display, underscore for ID)
Optionally create
Cloudflare D1 database and R2 buckets, update wrangler.jsonc with database_id
Install
dependencies with
pnpm install
Run
local database migration with
pnpm run db:migrate:local
Initial commit
Step 3: Manual Configuration
After the script completes:
Google OAuth
(if using):
Go to
Google Cloud Console
Create OAuth 2.0 Client ID
Add redirect URI:
http://localhost:5173/api/auth/callback/google
Copy Client ID and Secret to
.dev.vars
Favicon
Replace
public/favicon.svg
with your own
CLAUDE.md
Update project description and remove vite-flare-starter references
index.html
Update
and meta description
Step 4: Verify Locally
pnpm
dev
Check:
http://localhost:5173
loads
Shows YOUR app name, not "Vite Flare Starter"
Sign-up/sign-in works (if Google OAuth configured)
Step 5: Deploy to Production</dd>
</dl>
</dd>
</dl>
</dd>
</dl>
<h1 id="set-production-secrets">Set production secrets</h1>
<p>openssl rand
-base64
32
|
npx wrangler secret put BETTER_AUTH_SECRET
echo
"https://PROJECT_NAME.SUBDOMAIN.workers.dev"
|
npx wrangler secret put BETTER_AUTH_URL
echo
"http://localhost:5173,https://PROJECT_NAME.SUBDOMAIN.workers.dev"
|
npx wrangler secret put TRUSTED_ORIGINS</p>
<h1 id="if-using-google-oauth">If using Google OAuth</h1>
<p>echo
"your-client-id"
|
npx wrangler secret put GOOGLE_CLIENT_ID
echo
"your-client-secret"
|
npx wrangler secret put GOOGLE_CLIENT_SECRET</p>
<h1 id="migrate-remote-database">Migrate remote database</h1>
<p>pnpm
run db:migrate:remote</p>
<h1 id="build-and-deploy">Build and deploy</h1>
<dl>
<dt>pnpm</dt>
<dt>run build</dt>
<dt>&&</dt>
<dt>pnpm</dt>
<dt>run deploy</dt>
<dt>Critical</dt>
<dd>After first deploy, update BETTER_AUTH_URL with your actual Worker URL. Also add the production URL to Google OAuth redirect URIs.
Common Issues
Symptom
Cause
Fix
Auth silently fails (redirect to homepage)
Missing TRUSTED_ORIGINS
Set TRUSTED_ORIGINS secret with all valid URLs
"Not authorized" on deploy
Wrong account_id
Remove account_id from wrangler.jsonc or set yours
Database operations fail
Using original database_id
Create YOUR database, use YOUR database_id
localStorage shows "vite-flare-starter"
Missing VITE_APP_ID
Set
VITE_APP_ID=yourapp
in .dev.vars
Auth fails in production
BETTER_AUTH_URL mismatch
Must match actual Worker URL exactly
What Gets Rebranded
The setup process handles these automatically:
File
What Changes
wrangler.jsonc
Worker name, database name, bucket names
package.json
Package name, database references in scripts
.dev.vars
App name, secret, URL
index.html
Title, meta tags
These need manual attention:
CLAUDE.md
— project description
public/favicon.svg
— your favicon
Google OAuth — redirect URIs
Production secrets — via
wrangler secret put
See
references/customization-guide.md
for the complete rebranding checklist.</dd>
</dl>
</article>
<a href="/" class="back-link">← <span data-i18n="detail.backToLeaderboard">返回排行榜</span></a>
</div>
<aside class="sidebar">
<section class="related-skills" id="relatedSkillsSection">
<h2 class="related-title" data-i18n="detail.relatedSkills">相关 Skills</h2>
<div class="related-list" id="relatedSkillsList">
<div class="skeleton-card"></div>
<div class="skeleton-card"></div>
<div class="skeleton-card"></div>
</div>
</section>
</aside>
</div>
</div>
<script src="https://unpkg.com/i18next@23.11.5/i18next.min.js" defer></script>
<script src="https://unpkg.com/i18next-browser-languagedetector@7.2.1/i18nextBrowserLanguageDetector.min.js" defer></script>
<script defer>
// Language resources - same pattern as index page
const resources = {
'zh-CN': null,
'en': null,
'ja': null,
'ko': null,
'zh-TW': null,
'es': null,
'fr': null
};
// Load language files (only current + fallback for performance)
async function loadLanguageResources() {
const savedLang = localStorage.getItem('i18nextLng') || 'en';
const langsToLoad = new Set([savedLang, 'en']); // current + fallback
await Promise.all([...langsToLoad].map(async (lang) => {
try {
const response = await fetch(`/locales/${lang}.json`);
if (response.ok) {
resources[lang] = { translation: await response.json() };
}
} catch (error) {
console.warn(`Failed to load ${lang} language file:`, error);
}
}));
}
// Load a single language on demand (for language switching)
async function loadLanguage(lang) {
if (resources[lang]) return;
try {
const response = await fetch(`/locales/${lang}.json`);
if (response.ok) {
resources[lang] = { translation: await response.json() };
i18next.addResourceBundle(lang, 'translation', resources[lang].translation);
}
} catch (error) {
console.warn(`Failed to load ${lang} language file:`, error);
}
}
// Initialize i18next
async function initI18n() {
try {
await loadLanguageResources();
// Filter out null values from resources
const validResources = {};
for (const [lang, data] of Object.entries(resources)) {
if (data !== null) {
validResources[lang] = data;
}
}
console.log('Loaded languages:', Object.keys(validResources));
console.log('zh-CN resource:', validResources['zh-CN']);
console.log('detail.home in resource:', validResources['zh-CN']?.translation?.detail?.home);
// 检查是否有保存的语言偏好
const savedLang = localStorage.getItem('i18nextLng');
// 如果没有保存的语言偏好，默认使用英文
const defaultLang = savedLang && ['zh-CN', 'en', 'ja', 'ko', 'zh-TW', 'es', 'fr'].includes(savedLang)
? savedLang
: 'en';
await i18next
.use(i18nextBrowserLanguageDetector)
.init({
lng: defaultLang, // 强制设置初始语言
fallbackLng: 'en',
supportedLngs: ['zh-CN', 'en', 'ja', 'ko', 'zh-TW', 'es', 'fr'],
resources: validResources,
detection: {
order: ['localStorage'], // 只使用 localStorage，不检测浏览器语言
caches: ['localStorage'],
lookupLocalStorage: 'i18nextLng'
},
interpolation: {
escapeValue: false
}
});
console.log('i18next initialized, language:', i18next.language);
console.log('Test translation:', i18next.t('detail.home'));
// Set initial language in selector
const langSwitcher = document.getElementById('langSwitcher');
langSwitcher.value = i18next.language;
// Update page language
updatePageLanguage();
// Language switch event
langSwitcher.addEventListener('change', async (e) => {
await loadLanguage(e.target.value); // load on demand
i18next.changeLanguage(e.target.value).then(() => {
updatePageLanguage();
localStorage.setItem('i18nextLng', e.target.value);
});
});
} catch (error) {
console.error('i18next init failed:', error);
}
}
// Translation helper
function t(key, options = {}) {
return i18next.t(key, options);
}
// Update all translatable elements
function updatePageLanguage() {
// Update HTML lang attribute
document.documentElement.lang = i18next.language;
// Update elements with data-i18n attribute
document.querySelectorAll('[data-i18n]').forEach(el => {
const key = el.getAttribute('data-i18n');
el.textContent = t(key);
});
}
// Copy command function
function copyCommand() {
const command = document.getElementById('installCommand').textContent;
const btn = document.getElementById('copyBtn');
navigator.clipboard.writeText(command).then(() => {
btn.textContent = t('copied');
btn.classList.add('copied');
setTimeout(() => {
btn.textContent = t('copy');
btn.classList.remove('copied');
}, 2000);
}).catch(() => {
// Fallback for non-HTTPS
const textArea = document.createElement('textarea');
textArea.value = command;
textArea.style.position = 'fixed';
textArea.style.left = '-9999px';
document.body.appendChild(textArea);
textArea.select();
document.execCommand('copy');
document.body.removeChild(textArea);
btn.textContent = t('copied');
btn.classList.add('copied');
setTimeout(() => {
btn.textContent = t('copy');
btn.classList.remove('copied');
}, 2000);
});
}
// Initialize
document.getElementById('copyBtn').addEventListener('click', copyCommand);
initI18n();
// 异步加载相关 Skills
async function loadRelatedSkills() {
const owner = 'jezweb';
const skillName = 'vite-flare-starter';
const currentLang = 'zh-TW';
const listContainer = document.getElementById('relatedSkillsList');
const section = document.getElementById('relatedSkillsSection');
try {
const response = await fetch(`/api/related-skills/${encodeURIComponent(owner)}/${encodeURIComponent(skillName)}?limit=6`);
if (!response.ok) {
throw new Error('Failed to load');
}
const data = await response.json();
const relatedSkills = data.related_skills || [];
if (relatedSkills.length === 0) {
// 没有相关推荐时隐藏整个区域
section.style.display = 'none';
return;
}
// 渲染相关 Skills
listContainer.innerHTML = relatedSkills.map(skill => {
const desc = skill.description || '';
const truncatedDesc = desc.length > 60 ? desc.substring(0, 60) + '...' : desc;
return `
<a href="${currentLang === 'en' ? '' : '/' + currentLang}/skill/${skill.owner}/${skill.repo}/${skill.skill_name}" class="related-card">
<div class="related-name">${escapeHtml(skill.skill_name)}</div>
<div class="related-meta">
<span class="related-owner">${escapeHtml(skill.owner)}</span>
<span class="related-installs">${skill.installs}</span>
</div>
<div class="related-desc">${escapeHtml(truncatedDesc)}</div>
</a>
`;
}).join('');
} catch (error) {
console.error('Failed to load related skills:', error);
// 加载失败时显示提示或隐藏
listContainer.innerHTML = '<div class="related-empty">暂无相关推荐</div>';
}
}
// HTML 转义
function escapeHtml(text) {
const div = document.createElement('div');
div.textContent = text;
return div.innerHTML;
}
// 页面加载完成后异步加载相关 Skills
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', loadRelatedSkills);
} else {
loadRelatedSkills();
}
</script>
</body>
</html>