{"id":31016967,"url":"https://github.com/mesinkasir/axcora-starter","last_synced_at":"2025-09-13T07:30:23.566Z","repository":{"id":312417657,"uuid":"1043013004","full_name":"mesinkasir/axcora-starter","owner":"mesinkasir","description":"The Starter Project for Axcora SSG","archived":false,"fork":false,"pushed_at":"2025-09-09T02:05:02.000Z","size":244,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-09T04:52:21.756Z","etag":null,"topics":["component","components","css","css-components","css-framework","jamstack","static-site","static-site-generator","website","website-development"],"latest_commit_sha":null,"homepage":"https://ssg.axcora.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mesinkasir.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"mesinkasir","custom":["https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=JVZVXBC4N9DAN","https://creativitaz.gumroad.com/coffee"]}},"created_at":"2025-08-23T01:07:45.000Z","updated_at":"2025-09-09T02:05:05.000Z","dependencies_parsed_at":"2025-08-30T14:25:54.940Z","dependency_job_id":"91f7881b-8833-4cd5-bd34-e5829376b0fd","html_url":"https://github.com/mesinkasir/axcora-starter","commit_stats":null,"previous_names":["mesinkasir/axcora-starter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mesinkasir/axcora-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mesinkasir%2Faxcora-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mesinkasir%2Faxcora-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mesinkasir%2Faxcora-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mesinkasir%2Faxcora-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mesinkasir","download_url":"https://codeload.github.com/mesinkasir/axcora-starter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mesinkasir%2Faxcora-starter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274934666,"owners_count":25376694,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-13T02:00:10.085Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["component","components","css","css-components","css-framework","jamstack","static-site","static-site-generator","website","website-development"],"created_at":"2025-09-13T07:30:19.462Z","updated_at":"2025-09-13T07:30:23.458Z","avatar_url":"https://github.com/mesinkasir.png","language":"TypeScript","funding_links":["https://github.com/sponsors/mesinkasir","https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=JVZVXBC4N9DAN","https://creativitaz.gumroad.com/coffee","https://www.paypal.com/paypalme/creativitas"],"categories":[],"sub_categories":[],"readme":"# Axcora Framework\n\n[![npm version](https://img.shields.io/npm/v/axcora.svg?style=flat-square)](https://npmjs.com/package/axcora)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Support](https://img.shields.io/badge/Support-Donate-blue)](https://www.paypal.com/paypalme/creativitas)\n\n\u003e **All-in-One Static Site Generator \u0026 CSS Framework**  \n\u003e Build modern, responsive static sites with a powerful build system, reusable UI components, auto-SEO, and built-in dark mode—all in one toolkit.\n\n---\n\n## 🌐 Documentation\n\n- 📚 [Official Docs](https://ssg.axcora.com)\n- 🧩 [Component Library](https://ssg.axcora.com/components)\n\n---\n\n## ✨ Overview\n\n**Axcora** is a full-featured toolkit to build beautiful, lightweight, high-grade static websites easily. \nCombine a next-gen static site generator (Markdown/YAML/templating) with a modular CSS framework and rich UI component library — ideal for blogs, docs, portfolios, or any modern web project.\n\n---\n\n## 🚀 Key Features\n\n- **Automatic Static Site Generation:**  \n  Every markdown file in the `content/` directory becomes a fully linked page, blog post, tag, and category, with slugs and navigation auto-generated.\n\n- **Modular Templating with `.axcora`:**  \n  Use `.axcora` templates, layouts, partials, blocks, slots, and frontmatter for flexible, composable, DRY page structures.\n\n- **Built-in CSS Framework:**  \n  No third-party CSS required: comes bundled with modern, minified CSS for every component, dark mode, utility classes, and responsive layouts, powered by Axcora.\n\n- **Automatic, Page-Level SEO:**  \n  Meta tags, Open Graph, canonical links, sitemaps and RSS are built for you, every build—no plugin or config needed.\n\n- **Per-Page CSS Minification:**  \n  CSS is bundled and minified by page for ultra-fast CDN delivery.\n\n- **Lightning-fast Search Index:**  \n  Creates a full-text JSON index for blazing-fast, local search.\n\n- **Ready for Any Hosting:**  \n  Deploy to Netlify, Vercel, GitHub Pages, Cloudflare — any static host.\n\n---\n\n## 🏁 Getting Started\n\n### 1. Installation\n\nRequires **Node.js v20+**\n\nQuick Start\n\n```bash\nnpm install -g axcora\naxcora -V\naxcora init myproject\ncd myproject\nnpm install\naxcora dev\nopen localhost:3000\naxcora build\nupload your public folder in to your host\naxcora serve\n```\n\n### 2. Initialize and Build\n\n```bash\nnpx axcora init myproject\ncd myproject\nnpm install\nnpm run build\n```\n\n### 3. Start Development Server\n\n```bash\naxcora dev\nor\nnpm run dev\n```\n\nOpen your browser at `http://localhost:8080` (default) to preview.\n\n### 4. Build for Production\n\n```bash\naxcora build\nor\nnpm run build\n```\n\n### 5. Serve Production Build\n\n```bash\naxcora serve \nor \nnpm start\n```\n\n---\n\n## 🎨 Using the CSS Framework\n\n**Via NPM:**\n```bash\nnpm install axcora             # bundle ssg + css\nnpm install axcora-css         # install css components only\n```\n\n**Or inject via CDN:**  \n```html\n\u003clink href=\"https://cdn.jsdelivr.net/npm/axcora-css@1.0.1/axcora.min.css\" rel=\"stylesheet\"\u003e\n\u003cscript src=\"https://cdn.jsdelivr.net/npm/axcora-js@1.0.1/axcora.min.js\"\u003e\u003c/script\u003e\n```\n\n---\n\n## 📂 Example Project Structure\n\n```\nmyproject/\n├── content/\n│   ├── index.md\n│   └── blog/\n├── src/\n│   └── templates/\n├── static/\n│   └── img/\n├── axcora.config.ts\n└── package.json\n```\n\n---\n\n## 📦 Bundle Sizes\n\n- **Base:** 15.6 KB\n- **Essentials:** 19.6 KB\n- **Minified:** 43.7 KB\n- **JavaScript:** 11.8 KB\n\n---\n\n## 🧩 Using Components in Markdown \u0026 Templating\n\nAxcora enables **per-page component usage** via frontmatter in your markdown and `.axcora` template layouts. The build system will analyze your needs and automatically bundle and minify only the CSS and JS you specify—resulting in highly optimized, modern static sites.\n\n### Markdown Article Example\n\n```markdown\n---\ntitle: \"Blockquote\"\ndate: \"2025-08-22\"\ntags: \n  - blockquote\n  - blockquote axcora\n  - blockquote components\ncategory: \"components\"\ndescription: \"How to use blockquote component\"\nimage: \"/img/ax-1.jpg\"\ncss:\n  theme: 'essentials'\n  components:\n    - buttons\n    - navbar\n    - blockquote\n    - hero\n    - breadcrumb\n    - pagination\n    - image\n    - cards\njs:\n  - navbar\n  - theme\n---\nThe **Blockquote component** in Axcora SSG provides a visually appealing way to display quotations, statements, or testimonials, allowing emphasis and proper attribution for quoted material within both templates and article content.\n\n\u003e “This is a sample blockquote. Use it to highlight important content, testimonials, or citations.”\n```\n\n- **What happens?**  \n  - Only listed CSS components and JS modules will be included for this page.\n  - Axcora generates optimized, minified CSS/JS based on this configuration.\n  - You can use blockquotes and other components directly in your markdown content, taking advantage of the imported styles and logic.\n\n---\n\n### Axcora Templating Example (`.axcora`)\n\nFrontmatter and template code (`src/templates/blog/single.axcora`):\n\n```axcora\n---\nlayouts: base\ncss:\n  theme: 'essentials'\n  components:\n    - buttons\n    - navbar\n    - badge\n    - hero\n    - breadcrumb\n    - pagination\n    - cards\njs:\n  - navbar\n  - theme\n---\n\u003cheader class=\"hero container content-start mb-3\"\u003e\n  \u003cdiv class=\"hero-content\"\u003e\n    \u003ch1\u003e\n      \u003ca href=\"{{url}}\" class=\"text-white text-decoration-none\"\u003e{{ name }}\u003c/a\u003e\n    \u003c/h1\u003e\n    \u003cp class=\"lead text-muted\"\u003e{{ description }}\u003c/p\u003e\n  \u003c/div\u003e\n\u003c/header\u003e\n\n\u003c!-- Usage in template (example): --\u003e\n\u003cblockquote class=\"axcora-blockquote\"\u003e\n  \u003cp\u003e{{ quote }}\u003c/p\u003e\n  \u003cfooter\u003e{{ author }}\u003c/footer\u003e\n\u003c/blockquote\u003e\n```\n\n- **What happens?**  \n  - Each template can define its own CSS/JS needs in its frontmatter.\n  - When rendered, the page will include only the selected CSS components and JavaScript for optimal performance.\n  - Use all Axcora UI elements (e.g. blockquote, badges, buttons) directly in your layouts, inheriting from the theme and components you specify.\n\n---\n\n### 💡 **Why Component-Level Import?**\n\n- **Ultra-fast builds \u0026 loads:** No global bloated CSS—only what’s needed, per-page.\n- **Modular:** Easily control which features or UI parts are available on each page or template.\n- **Productivity:** Organize content, structure, and appearance via frontmatter and templates without ever editing raw CSS or JS!\n\n---\n\nFor a full list of available components and layout examples, [see the documentation](https://ssg.axcora.com/components/).\n\n---\n\n**Tip:**  \nWhen you add or remove components in `css.components` or `js`, the build output will automatically change to include only those assets—making your site lighter and faster.\n\n---\n\n## 🧱 Ready-to-Use Axcora Components\n\nAxcora ships with a growing library of elegant, production-ready UI components.  \nYou can use these components directly inside your markdown articles **and** `.axcora` templates using simple, readable tags. The build system will collect and render them as semantic HTML with the appropriate CSS and JS automatically applied.\n\n### Example: Using Components in Markdown \u0026 Templates\n\n**Button Component**\n```markdown\n{% axcora-button text=\"Click Me\" href=\"/\" color=\"primary\" /%}\n```\n\n**Accordion Component**\n```markdown\n{% axcora-accordion \n    id=\"demo\"\n    title1=\"Axcora Accordion\"\n    text1=\"hello world lorem ipsum dolor\"\n    title2=\"Axcora Accordion 2\"\n    text2=\"hello world lorem ipsum dolor 2\"\n    title3=\"Axcora Accordion 3\"\n    text3=\"hello world lorem ipsum dolor 3\"\n/%}\n```\n\nYou can use these tags inside your `.md` content or `.axcora` templates.  \n**Each component tag will be rendered into styled HTML and only the required CSS/JS will be included in the final build.**\n\n---\n\n### 🔥 Popular Components\n\n- `{% axcora-button %}` – Stylish buttons with color, link, and icon support.\n- `{% axcora-accordion %}` – Expandable/collapsible content areas.\n- `{% axcora-badge %}` – Highlighted badges for status and info.\n- `{% axcora-blockquote %}` – Attractive blockquotes/testimonials.\n- `{% axcora-hero %}` – Large visual “hero” sections for splash headlines.\n- `{% axcora-card %}` – Cards for content, images, and feature boxes.\n- `{% axcora-navbar %}` – Responsive page navigation.\n- `{% axcora-tabs %}` – Tabbed content switching.\n- `{% axcora-toast %}` – Toast/notification messages.\n- `{% axcora-image %}` – Responsive images.\n\n…and many more!\n\n---\n\n### 🚀 **How It Works**\n\n1. **Add components in your markdown or `.axcora` template** using their respective tags and desired attributes.\n2. **Declare the required components in your frontmatter** under `css.components` and `js` (see previous section), or set them globally in your layout.\n3. **Axcora SSG automatically renders the component HTML and bundles/minifies only the CSS/JS you use** for each page.\n\n---\n\n\u003e For a full list of available components, usage options, and demos, see the [Axcora Components Documentation](https://ssg.axcora.com/components/).\n\n---\n\nThis makes building advanced, modular static sites fast, intuitive, and fully customizable—no manual JavaScript or CSS imports needed. Use components where you want them, and enjoy optimal performance by design.\n\n---\n\n## 🎨 Theme Your Site: Flexible Built-in Themes\n\nAxcora ships with a suite of vibrant, production-ready CSS themes you can choose and swap at any time—whether you love minimalist, brutalist, corporate, or neon cyberpunk vibes.\n\n**Just specify your preferred theme in your frontmatter or template:**\n\n```yaml\ncss:\n  theme: \"essentials\"    # Pick from: essentials, brutal, corporate, cyberpunk, dark, minimal, startup\n```\n\n### **Available Themes**\n| Theme      | Description                    |\n| ---------- | ----------------------------- |\n| `essentials` | Clean, modern, accessible UI – default “sane” look for blogs, docs, all-purpose |\n| `brutal`     | Bold, thick lines \u0026 neon gradient—90s brutalist \u0026 fun, great for creative sites |\n| `corporate`  | Flat, pro, business/classic – ideal for company portals or portfolios           |\n| `cyberpunk`  | Neon, glowing, synthwave gradients – inspired by the digital future             |\n| `dark`       | Universal dark mode — great for night reading and moody aesthetics              |\n| `minimal`    | Ultra-clean, understated, reader-first layouts – focus on content               |\n| `startup`    | Stylish, colorful, and dynamic – perfect for landing pages, projects            |\n\n\n### **How To Use Themes**\n\nIn your Markdown or `.axcora` template frontmatter:\n\n```yaml\ncss:\n  theme: \"cyberpunk\"\n  components:\n    - buttons\n    - blockquote\n    - navbar\n```\n\nOr swap it any time to:\n\n```yaml\ncss:\n  theme: \"minimal\"\n```\n\nAxcora will **automatically import and optimize** the right theme styles and variables for you.\n\n---\n\n### **How to Install Extra Themes (Optional)**\n\nAll official themes are available as individual packages:\n\n- `axcora-theme-essentials`\n- `axcora-theme-brutal`\n- `axcora-theme-corporate`\n- `axcora-theme-cyberpunk`\n- `axcora-theme-dark`\n- `axcora-theme-minimal`\n- `axcora-theme-startup`\n\nInstall just the one(s) you need:\n\n```bash\nnpm install axcora-theme-cyberpunk\nnpm install axcora-theme-brutal\n```\n\n**Or install all to explore:**\n\n```bash\nnpm install axcora-theme-essentials axcora-theme-brutal axcora-theme-corporate axcora-theme-cyberpunk axcora-theme-dark axcora-theme-minimal axcora-theme-startup\n```\n\n---\n\n### **Preview Theme Variables**\nEach theme offers its own palette and font/spacing system—here’s a quick peek on how they feel:\n\n- **Essentials:** Modern, balanced variables for backgrounds, primary/secondary colors, muted states, alert programs, global spacing, border radius, and responsive text—optimized for dark/light.\n- **Brutal:** Strong color contrasts, boxy radiuses, neon highlights and heavy outlines for creative impact.\n- **Cyberpunk:** Bright gradients, glowing borders, neon fonts and backgrounds, dark digital mood.\n- **Minimal:** White background, nearly monochrome text, minimalist subtle shadows and muted accents.\n- **Dark:** Readable, low-fatigue backgrounds and text, universal dark mode experience.\n- **Corporate:** Office-inspired, classic styling, flat color blocks and understated detail.\n- **Startup:** Vibrant, fresh, colorful, full of modern design energy.\n\n---\n\n### **Example: Switch Theme Per Page**\nWant a wild cyberpunk homepage but a minimal docs section?  \nJust pick a theme per file:\n\n```yaml\n---\ncss:\n  theme: \"cyberpunk\"\n---\n```\nand\n```yaml\n---\ncss:\n  theme: \"minimal\"\n---\n```\n**Mix, match, override!**\n\n---\n\n💡 **Tip:** All of these themes are fully compatible with the Axcora component system and support both light and dark mode (where available).\n\n---\n\n_Easily set your brand or project style—no more fiddling with config or hand-written CSS. Just pick your theme and build!_\n\n---\n\n## 🙌 Support This Project\n\n- [Donate via Paypal](https://www.paypal.com/paypalme/creativitas)  \n- [Sponsor on Github](https://github.com/sponsors/mesinkasir)\n- [Coffee/Gumroad](https://creativitaz.gumroad.com/coffee)\n\n---\n\n## 🔗 License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n---\n\n\u003e Built \u0026 maintained by **Axcora Tech** — fast, scalable, and open source static site tooling for creators, developers, and teams.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmesinkasir%2Faxcora-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmesinkasir%2Faxcora-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmesinkasir%2Faxcora-starter/lists"}