Skip to content
KomeStudioPublic

Latest commit

 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

Kome WebCore

Astro + Sveltia CMS starter for fast, SEO-friendly Jamstack websites

Shared, production-ready codebase powering komestudio.com and kome.top.

License: GPL-3.0 Astro Tailwind CSS TypeScript Cloudflare Pages PRs Welcome

🌐 Kome Studio · 🔗 Kome Top · 🐞 Report an issue


🧭 About

Kome WebCore is the shared website engine behind the Kome ecosystem. It combines Astro (via the AstroWind template), Tailwind CSS, TypeScript and Sveltia CMS (a Git-based headless CMS) into a fast, SEO-friendly static site that deploys for free on Cloudflare Pages.

One codebase, multiple sites: each site keeps its own content, branding and config, while core components, layouts and SEO logic are maintained in one place.


🌐 Sites in this repo

Site Domain Branch Purpose
Kome Studio komestudio.com komestudio Official website of Kome Studio — indie game studio.
Kome Top kome.top kome-top Kome portal — gateway to projects, resources and guides.

📝 The blog at blog.komestudio.com is hosted separately on Blogger.


✨ Features

  • ⚡ Blazing fast — static output, zero JS by default, excellent Lighthouse / Core Web Vitals scores.
  • 🔍 SEO built in — meta tags, Open Graph, Twitter Cards, canonical URLs, XML sitemap, RSS feed, robots.txt and structured data (JSON-LD).
  • 📝 Git-based headless CMS — edit content visually with Sveltia CMS; no database, no server.
  • 🎨 Tailwind CSS — responsive, dark-mode-ready, easy to rebrand.
  • 🖼️ Image optimization — automatic resizing and modern formats (WebP/AVIF).
  • 🧱 Reusable widgets — hero, features, pricing, FAQ, blog, contact and more.
  • 🌍 Multi-site ready — reuse the same core across several domains.
  • ☁️ One-click deploy — Cloudflare Pages with automatic builds on every push.

🧱 Tech Stack

Layer Technology
Framework Astro via AstroWind
Styling Tailwind CSS
Language TypeScript
CMS Sveltia CMS
Content Markdown / MDX
Hosting Cloudflare Pages
Version control Git + GitHub

🚀 Quick Start

Requirements: Node.js >= 18.17.1 and npm.

# 1. Clone
git clone https://github.com/KomeStudio/WebCore.git
cd WebCore

# 2. Install dependencies
npm install

# 3. Run locally → http://localhost:4321
npm run dev

# 4. Build for production → ./dist
npm run build

# 5. Preview the production build
npm run preview

🌿 Branch Strategy

Branch Purpose Deploys to
main Source of truth, shared core —
komestudio Site config for komestudio.com Cloudflare Pages → komestudio.com
kome-top Site config for kome.top Cloudflare Pages → kome.top

Per-site config lives in src/config.yaml — only this file (and content folders) differ between branches.

To sync core updates from main into a site branch:

git checkout komestudio
git merge main
git push

✍️ Content Management (Sveltia CMS)

  1. Open /admin on your site (local or deployed).
  2. Sign in with your Git provider.
  3. Edit pages, posts and settings — changes are committed to the repository and trigger a new deploy.

Collections and fields are defined in the CMS config file: /public/admin/config.yml.

Content lives in:

Path Purpose
src/content/posts/ Blog posts
src/content/pages/ Static pages
public/images/uploads/ Uploaded media

☁️ Deploy to Cloudflare Pages

Setting Value
Framework preset Astro
Build command npm run build
Output directory dist
Node version 18 or newer

Connect the repository, set your custom domain (e.g. komestudio.com, kome.top), and every push to the site branch deploys automatically.


🔍 SEO Checklist for Each Site

  • Set the site URL, title and description in the site config.
  • Add a unique title and description to every page and post.
  • Provide an Open Graph image (1200×630).
  • Submit sitemap-index.xml to Google Search Console and Bing Webmaster Tools.
  • Verify canonical URLs point to the primary domain.

📁 Project Structure

.
├── public/
│   ├── admin/              # Sveltia CMS (index.html + config.yml)
│   ├── images/uploads/     # CMS-uploaded media
│   └── favicon.svg
├── src/
│   ├── components/         # Astro components
│   ├── content/            # Markdown content collections
│   ├── layouts/            # Page layouts
│   ├── pages/              # File-based routes
│   ├── styles/             # Global CSS
│   └── config.yaml         # ⚠️ Per-site config (differs per branch)
├── astro.config.ts
├── tailwind.config.ts
├── package.json
└── README.md

🔐 Environment & Secrets

No runtime secrets are needed for the static build. OAuth proxy credentials for Sveltia CMS are configured outside this repo (Cloudflare Worker + GitHub OAuth App).


🤝 Contributing

Issues and pull requests are welcome. For bugs or feature requests, please open an issue.


🙏 Credits

Built on AstroWind, Astro, Tailwind CSS and Sveltia CMS.


📄 License

Released under the GPL-3.0 license. See LICENSE for details. © 2026 Kome Studio


🇻🇳 Tiếng Việt

Kome WebCore là bộ mã nguồn website dùng chung (Astro + AstroWind + Sveltia CMS + Tailwind CSS) cho komestudio.com và kome.top. Website tĩnh tốc độ cao, chuẩn SEO, quản lý nội dung bằng CMS trực quan và triển khai miễn phí trên Cloudflare Pages.

Keywords: Kome Studio, komestudio.com, kome.top, Astro template, AstroWind, Sveltia CMS, headless CMS, Jamstack, static site generator, Tailwind CSS, TypeScript, Cloudflare Pages, SEO website template, game studio website.

Releases

Packages

Contributors

Generated from KomeCafe/kami