{"id":22425340,"url":"https://github.com/csymapp/csycms-cli","last_synced_at":"2025-10-29T08:05:39.508Z","repository":{"id":101250333,"uuid":"343675910","full_name":"csymapp/csycms-cli","owner":"csymapp","description":"A static site generator, markdown powered knowledge-base, and API server for node.js","archived":false,"fork":false,"pushed_at":"2021-07-01T05:29:59.000Z","size":958,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-13T03:05:23.425Z","etag":null,"topics":["api-server","csycms","csycms-cli","flat-file-cms","knowledge-base","static-site-generator"],"latest_commit_sha":null,"homepage":"https://csycms.csymapp.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/csymapp.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":"2021-03-02T06:57:52.000Z","updated_at":"2022-04-23T00:43:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"23990423-3633-4ce8-b003-7ddd79d4ed86","html_url":"https://github.com/csymapp/csycms-cli","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/csymapp/csycms-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csymapp%2Fcsycms-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csymapp%2Fcsycms-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csymapp%2Fcsycms-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csymapp%2Fcsycms-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/csymapp","download_url":"https://codeload.github.com/csymapp/csycms-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csymapp%2Fcsycms-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281584979,"owners_count":26526171,"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-10-29T02:00:06.901Z","response_time":59,"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":["api-server","csycms","csycms-cli","flat-file-cms","knowledge-base","static-site-generator"],"created_at":"2024-12-05T19:13:51.076Z","updated_at":"2025-10-29T08:05:39.502Z","avatar_url":"https://github.com/csymapp.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# csycms CLI\n\nCSYCMS, acronym for **Csyber Systems Content Management System** is a:\n1. Markdown powered (blog aware) static site generator, \n2. markdown powered knowledge-base, \n3. Flat-file CMS, and\n3. API server for node.js\n\n\u003e If we had known about Jekyll in 2018 (3 years ago) when we began this project, we would probably have chosen to use it for building our sites. But now three years down the line we been able to add features that Jekyll does not have and it would be more expensive for us to switch over to it than to keep patching things up here an adding new features that we need along the way. \u003cbr\u003e\n\u003e — Brian Onang'o, csycms developer.\n\n\n# Table of Contents\n- [Inspiration](#inspiration)\n- [Features](#features)\n- [Comparison with Other Systems](#comparison-with-other-systems)\n- [Requirements](#requirements)\n- [QuickStart](#quickstart)\n - [From GitHub](#from-github)\n- [Features](#features)\n - [Common Features](#common-features)\n - [Unique Features](#unique-features)\n - [Other Advantages](#other-advantages)\n- [Configuration](#configuration)\n- [Updating](#updating)\n- [Contributing](#contributing)\n- [Security issues](#security-issues)\n- [License](#license)\n- [Todo](#todo)\n\n## Inspiration\nWe received much inspiration for this project from [php's User Frosting](https://www.userfrosting.com/) and [node's Raneto](http://raneto.com/)\n\n**[⬆ back home](#table-of-contents)**\n\n## Features\n- **Static Site Generation** - You can build your site and with one command generate a static site to be hosted for instance on github pages.\n- **Static Site server** - You can also choose not to build run your site and server it using csycms.\n- **API server** - You can also choose to have csycms server the API for your site, but have the front end hosted elsewhere or also from csycms.\n- **Multiple sites** - You can build and server multiple sites using csycms\n\nVisit [http://learn.csycms.csymapp.com](http://learn.csycms.csymapp.com) to see a demo and get started!\n\nThe underlying architecture of CSYCMS is designed to use well-established and _best-in-class_ technologies. Some of these key technologies include:\n\n* [Markdown](http://en.wikipedia.org/wiki/Markdown): for easy content creation\n* [Hogan Templating](http://twitter.github.io/hogan.js/): for powerful control of the user interface\n* Microservices to make deployments of multiple sites more stable\n\nWelcome to the world of [CSECO](https://www.cseco.co.ke) and [Csyber Systems](https://github.com/csymapp) where every other words begins with `cs`, pronouced `psy`. So that `csycms` is pronounced `psy cms`   \n\n**[⬆ back home](#table-of-contents)**\n\n## Comparison with Other Systems\n### Jekyll\n1. csycms is built with node, Jekyll with Ruby.\n2. csycms has an api server, Jekyll seems not to have one.\n3. both generate sites which can be hosted on github pages\n\n### Grav\n1. Grav is php, csycms is node.\n2. Grav is a CPU gazzler especially when performing a search. csycms tries not to be.\n\n### Raneto\n1. csycms has an api server, Raneto seems not to have one.\n2. csycms can host several sites.\n\n\u003e Therefore, while the other systems (listed above and more) are older and more stable, in our own little world here, csycms seems to have features that they lack.\n\n**[⬆ back home](#table-of-contents)**\n\n## Requirements\n\n- OS: linux\n- Node v12+\n\nIf you intend to use csycms to server your sites, then you'll need to install nginx to set up a reverse proxy.\n\n**[⬆ back home](#table-of-contents)**\n\n## QuickStart\n\n```bash\nnpm install -g csycms\nsudo csycms init\nsudo csycms site --create -n \"$SITENAME\" -p \"$PORT\"\n```\n\nEdit site configurations in `/etc/csycms/sites-available/$SITENAME`\n\nOnce you have editted the configurations, you can restart the subprocess serving the site using `csycms site --restart -n $SITENAME`\n\n# Configuration\n\nSet configurations in `/etc/projectname/config/system.yml` with:\n```yaml\nsshKey: ~/.ssh/id_rsa # ssh key\nPORT: 2121 # port for communication between csycms and sites\nupdate: 86400 # system update interval in seconds\n```\n\n## todo\n- [ ] Contact Page on site template \u0026 co.\n- [ ] Custom Error Pages.\n- [ ] Protected Content.\n- [ ] Search.\n- [ ] http -\u003e https on github pages\n- [ ] Built with csycms\n- [ ] sync site without message\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcsymapp%2Fcsycms-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcsymapp%2Fcsycms-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcsymapp%2Fcsycms-cli/lists"}