{"id":16843359,"url":"https://github.com/barttc/starcel","last_synced_at":"2025-11-08T12:30:37.517Z","repository":{"id":44149816,"uuid":"179732485","full_name":"bartTC/starcel","owner":"bartTC","description":"Starcel is a static page generator that helps you to transforms HTML/CSS/JS using ParcelJS.","archived":true,"fork":false,"pushed_at":"2023-01-07T04:27:11.000Z","size":3574,"stargazers_count":3,"open_issues_count":12,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-10T21:36:23.311Z","etag":null,"topics":["parcel","parcel-bundler","scss","static-site-generator"],"latest_commit_sha":null,"homepage":"","language":"HTML","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/bartTC.png","metadata":{"files":{"readme":"README.rst","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}},"created_at":"2019-04-05T18:11:29.000Z","updated_at":"2024-08-11T12:02:06.000Z","dependencies_parsed_at":"2023-02-06T11:46:36.174Z","dependency_job_id":null,"html_url":"https://github.com/bartTC/starcel","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bartTC%2Fstarcel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bartTC%2Fstarcel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bartTC%2Fstarcel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bartTC%2Fstarcel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bartTC","download_url":"https://codeload.github.com/bartTC/starcel/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239554733,"owners_count":19658271,"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","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":["parcel","parcel-bundler","scss","static-site-generator"],"created_at":"2024-10-13T12:50:39.140Z","updated_at":"2025-11-08T12:30:37.470Z","avatar_url":"https://github.com/bartTC.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"=======\nStarcel\n=======\n\nStarcel is a *static page generator* that helps you to transforms HTML/CSS/JS\nusing ParcelJS_. It is *not* a full-blown static site generator or CMS like\nGatsby_ or Hugo_.\n\n**You use Starcel when** you really only want to build a very simple, static\nwebsite, most often a one-pager.\n\nYou don't need CMS or anything that requires a 'backend'. You don't need\nblogging functionality.\n\nYou need SCSS, auto-reloading during development, compression and minification\nof the generated sources.\n\nYou don't want to re-invent the wheel every time.\n\nWorkflow:\n=========\n\n- ``src/`` folder is where all your project files are located.\n\n  ``build/`` folder is where the compiled and compressed files are generated.\n  The content of this folder is later deployed to a webserver. This is done in\n  the ``npm run build`` process.\n\n- SCSS files are automatically compiled to CSS.\n\n- HTML files run through posthtml_ where they are gently optimized. See the\n  ``posthtml.config.js`` file whats going on.\n\n- All files are minified/optimized.\n\n- Static files have a hash in their filename to overcome browser caching issues.\n\n- You will manually upload the files in ``build/`` to a webserver. Or you add\n  some fancy rsync command to do it for you on the fly.\n\nExample Project Site / Generated Site::\n\n  $ ls -lR src/\n  -rw-r--r--  1 martin  staff   825 Apr  5 20:09 index.html\n  -rw-r--r--  1 martin  staff  2514 Jan 10  2015 piet.jpg\n  -rw-r--r--  1 martin  staff   143 Apr  5 19:46 site.js\n  -rw-r--r--  1 martin  staff    87 Apr  5 19:46 site.scss\n\n  $ npm run build\n\n  $ ls -lR build/\n  -rw-r--r--  1 martin  staff   365 Apr  5 20:29 index.html\n  -rw-r--r--  1 martin  staff  2514 Apr  5 20:29 piet.c00ffa55.jpg\n  -rw-r--r--  1 martin  staff    44 Apr  5 20:29 site.225dc4b8.css\n  -rw-r--r--  1 martin  staff   193 Apr  5 20:29 site.dfbb479f.js\n\nInstallation \u0026 Usage\n====================\n\n#) Checkout this Github project and rename the foldername to your project name::\n\n    $ git clone git@github.com:bartTC/starcel.git my-project-name\n    $ cd my-project-name\n\n#) Install the helper files::\n\n    $ npm install\n\n#) Edit the files in the ``src/``. Delete what you don't need. This is only\n   an example.\n\n#) Run the ``build`` command and upload the generated files to your server::\n\n    $ npm run build\n\n#) Upload the generated files in ``build/`` to your webserver.\n\nCommands\n========\n\n* ``$ npm run build`` —  Compiles all files into the ``build/`` folder. All\n  files are   optimized and minimized. These are the files you will *manually*\n  upload to the server.\n\n* ``$ npm run devserver`` — Opens a webserver on ``localhost:1234``\n  serving the transformed files, with auto-reload of all files on changes,\n  and additional goodies such as source-maps.\n\n* ``$ npm run buildserver`` — Opens a webserver on ``localhost:1234`` serving\n  the content of the ``build/`` directory so you can see whats later been\n  deployed to the server. This has no auto-reload enabled.\n\n\n.. _ParcelJS: https://parceljs.org/\n.. _Gatsby: https://www.gatsbyjs.org/\n.. _Hugo: https://gohugo.io/\n.. _posthtml: https://github.com/posthtml/posthtml\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbarttc%2Fstarcel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbarttc%2Fstarcel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbarttc%2Fstarcel/lists"}