Publish a Website from a Workspace Folder
Most organizations manage their website in one tool, their media in another, their training content in a third, and their documents in a fourth. AppKask collapses the website into the same workspace where everything else lives.
The concept
A website in AppKask is a folder. Tag it with the yhm-site-data type and it becomes a website builder with a visual editor, structured data, and one-click publishing.
The folder contains three things:
- sitedef.yaml — your site definition: pages, menus, languages, themes, and settings
- data/ — page elements as JSON files (hero sections, stats grids, carousels, CTAs)
- content/ — blog posts and articles as MDX files
That’s it. No framework to learn, no build pipeline to configure, no deployment scripts to maintain.
How publishing works
Click Publish Site and the platform:
- Reads your
sitedef.yamland page data - Generates a complete Astro project with your content
- Builds the static site
- Pushes to your Git repository (Forgejo, Gitea, or any Git host)
- Your CI/CD takes it from there — or serve it directly from Forgejo Pages
The site is a static artifact. Fast, secure, and hostable anywhere. The data stays in your workspace.
20 element types
Pages are composed from a library of reusable elements:
| Element | What it does |
|---|---|
| Hero | Full-bleed header with title, description, image, and call-to-action |
| StatData | Statistics grid (revenue numbers, user counts, milestones) |
| Collection | Card grid pulling from your MDX articles |
| Carousel | Image or card carousel |
| Video | HLS video player with poster image |
| Process | Interactive BPMN process diagram |
| Presentation | Embedded slide deck |
| CTA | Multi-page form or survey |
| TeamGrid | Team member profiles |
| MdText | Rich text from your MDX content |
Each element is a JSON file with a weight field that controls ordering. Drag to reorder in the visual editor, toggle elements on and off with a draft flag.
Multi-language built in
Every page and every content file is organized by locale. Define your languages in sitedef.yaml and the generator produces a complete site for each. No plugins, no translation middleware — just folders.
Why this matters
Your website is no longer a separate project managed by a separate team with separate tools. It lives next to your media library, your training courses, and your process documentation. AI agents can create and edit content. Access codes can share the workspace. And when you’re ready, one click publishes everything.
The data is yours. The site is a derived artifact. Edit the source, click Publish, and the live site updates.