{"id":18777983,"url":"https://github.com/levimcg/jamster","last_synced_at":"2026-05-09T04:31:19.606Z","repository":{"id":73074698,"uuid":"233468643","full_name":"levimcg/jamster","owner":"levimcg","description":"A simple command line tool for generating markdown files with front matter for JAMstack sites","archived":false,"fork":false,"pushed_at":"2020-04-03T23:03:15.000Z","size":24,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-21T05:11:47.774Z","etag":null,"topics":["cli","front-matter","jamstack","markdown"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/levimcg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2020-01-12T22:31:12.000Z","updated_at":"2023-05-12T16:57:23.000Z","dependencies_parsed_at":null,"dependency_job_id":"8050512a-bc89-40fb-aa91-acf877495e1b","html_url":"https://github.com/levimcg/jamster","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/levimcg/jamster","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/levimcg%2Fjamster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/levimcg%2Fjamster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/levimcg%2Fjamster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/levimcg%2Fjamster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/levimcg","download_url":"https://codeload.github.com/levimcg/jamster/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/levimcg%2Fjamster/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32807150,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"online","status_checked_at":"2026-05-09T02:00:06.633Z","response_time":123,"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":["cli","front-matter","jamstack","markdown"],"created_at":"2024-11-07T20:14:36.400Z","updated_at":"2026-05-09T04:31:19.600Z","avatar_url":"https://github.com/levimcg.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤙 Jamster\nA simple command line tool for generating markdown files with front matter for JAMstack sites. Inspired by [Hugo's](https://gohugo.io/commands/hugo_new/) `hugo new`, but for the JavaScript ecosystem.\n\n## About\n- ⚡️Generates markdown files with front-matter like the ones typically used to manage content with static site generators like [Eleventy](https://www.11ty.dev/), [Jekyll](https://jekyllrb.com/), etc.\n- ✌️Written entirely in Node.js so it's cross-platform\n- 🔧Specify front-matter content per file by passing specific config files via the `--config` flag.\n\n## Getting started\nThe easiest way to use Jamster is to install in globally.\n\n```bash\nnpm install -g jamster\n\n# Test to make sure it was installed.\njamster --version\n# Should see a version number\n0.1.0\n```\n\nOnce once installed you can run it in your terminal from anywhere.\n\n```bash\njamster relative/path/to/new/file.md\n```\n\n### Installing locally\nIf you don't want to or can't install Jamster globally you can also install it locally in your project and then run it using `npx` (Requires npm 5.2.0+).\n\n```bash\nnpx jamster path/to/my/new/file.md\n```\n\n## Default generated front matter\nWithout passing any arguments Jamster will create a new markdown file at the path you specify with the following default front-matter added.\n\n```markdown\n---\ntitle: ''\ndescription: ''\ndate: (Current date)\n---\n```\n\n## Customizing generated front-matter\nIf you want to use different values in your generated front matter there are a couple of ways to do it.\n\n### Using a central `.config` file\nIf you want to use the same front-matter values for all generated markdown files you can place a file called `jamster.config.js` that exports a JavaScript Object with your desired values at the root of your project.\n\nHere's and example of how a `jamster.config.js` file might look.\n\n```javascript\n// ./jamster.config.js\n\nmodule.exports = {\n  title: 'My default title',\n  description: 'Default description'\n  date: new Date(), // You can use regular old Javascript in here!\n  tags: ['post', 'development'],\n  layout: 'layouts/post.njk'\n}\n```\n\nWith the this configuration file in place, you can then run\n\n```bash\njamster path/to/your/new/file.md\n```\n\nand the resulting front markdown file would contain the following front-matter:\n\n```markdown\n---\ntitle: 'My default title'\ndescription: 'Default description'\ndate: (Today's date)\ntags:\n  - post\n  - development\nlayout: 'layouts/post.njk'\n---\n```\n\n### Specify a configuration using the `--config` flag\nIf you want to use multiple different configuration files for different post type in you site, you can specify a different config file after entering the path to you new markdown file.\n\n#### Example\n```bash\njamster path/to/my/new/file.md --config path/to/config/myconfig.js\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flevimcg%2Fjamster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flevimcg%2Fjamster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flevimcg%2Fjamster/lists"}