{"id":16380555,"url":"https://github.com/davis-software/swc_pages","last_synced_at":"2026-06-25T05:31:26.858Z","repository":{"id":80837051,"uuid":"527975738","full_name":"Davis-Software/SWC_pages","owner":"Davis-Software","description":"Lightweight package-based webserver","archived":false,"fork":false,"pushed_at":"2023-01-11T20:36:17.000Z","size":15,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-01T20:46:23.778Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","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/Davis-Software.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}},"created_at":"2022-08-23T12:14:41.000Z","updated_at":"2024-01-12T18:35:49.000Z","dependencies_parsed_at":"2023-03-12T12:17:40.511Z","dependency_job_id":null,"html_url":"https://github.com/Davis-Software/SWC_pages","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/Davis-Software%2FSWC_pages","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Davis-Software%2FSWC_pages/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Davis-Software%2FSWC_pages/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Davis-Software%2FSWC_pages/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Davis-Software","download_url":"https://codeload.github.com/Davis-Software/SWC_pages/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240035753,"owners_count":19737602,"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":[],"created_at":"2024-10-11T03:51:45.719Z","updated_at":"2026-04-23T11:30:17.192Z","avatar_url":"https://github.com/Davis-Software.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"### SWC_pages\n\u003e Developed by [Davis_Software](https://github.com/Davis-Software) \u0026copy; 2022\n\n\u003e Demo: [Davis_Software Homepage](https://pages.software-city.org)\n\n---\n\nLightweight package-based webserver \u003cbr\u003e\nBasically Software City's version of [GitHub Pages](https://pages.github.com/) with some special features but also a lot less functionality.\n\n\n### Development\n```shell\npython3 -m venv venv\nsource venv/bin/activate\npip install -r requirements.txt\npython3 app.py\n```\n\n### config.ini\n\n###### Default:\n```\n# app config\nSECRET_KEY=\u003cflask session secret key\u003e\n\n# webserver config\nHOST=0.0.0.0\nPORT=80\nDEBUG=true\n\n# routing config\nDEFAULT_PAGE=test_website\nALLOW_LIST=true\n```\n\n###### Explanation:\n| Parameter         | Description                                        |\n|-------------------|----------------------------------------------------|\n| SECRET_KEY        | Flask session secret key                           |\n| HOST              | Host to listen on                                  |\n| PORT              | Port to listen on                                  |\n| DEBUG             | Enable debug mode                                  |\n| DEFAULT_PAGE      | ID of Default page to show if no page is specified |\n| ALLOW_LIST        | Enable allow list                                  |\n| WATCH_FOR_CHANGES | Enable automatic page reload on file change        |\n\n\n### Routing\n| Route                                | Description                                       |\n|--------------------------------------|---------------------------------------------------|\n| `/` and `/d`                         | Default page                                      |\n| `/j/\u003cpage id\u003e` and `/join/\u003cpage id\u003e` | Join page by id                                   |\n| `/list`                              | List of all pages (Must be enabled in config.ini) |\n\n* Once a page is joined by id, it will be remembered in the session cookie and will be shown by default.\n\n\n### Installing pages\nPages are installed by placing them in the `packages` folder. \u003cbr\u003e\nThe page must be a zip file containing a `manifest.json` file and all other website files:\nFolders are allowed and will be accessible through the route `/\u003cfolder\u003e`.\n\nWhen the server is started, the pages will be extracted to the `package_cache` folder.\nThis overwrites the old files, so if you want to update a page, you have to edit the zip file.\n\n* demo.zip\n  * \\\u003cadditional files\u003e\n  * index.html\n  * manifest.json\n\n###### manifest.json\n```json\n{\n    \"name\": \"Demo\",\n    \"description\": \"Demo page\",\n    \"author\": \"Davis_Software\",\n    \"version\": \"1.0.0\",\n    \"id\": \"demo\",\n    \"entry\": \"index.html\"                   // entry point of the page\n}\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavis-software%2Fswc_pages","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavis-software%2Fswc_pages","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavis-software%2Fswc_pages/lists"}