{"id":20486224,"url":"https://github.com/undp-data/st-undp","last_synced_at":"2026-05-18T02:03:00.571Z","repository":{"id":256185542,"uuid":"853703298","full_name":"UNDP-Data/st-undp","owner":"UNDP-Data","description":"A Python package that helps build Streamlit apps in line with UNDP Design System.","archived":false,"fork":false,"pushed_at":"2025-01-30T12:33:08.000Z","size":5549,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-16T04:52:51.045Z","etag":null,"topics":["data-futures-exchange","streamlit","streamlit-ui","undp","web-app"],"latest_commit_sha":null,"homepage":"https://undp-data.github.io/st-undp","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/UNDP-Data.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":"2024-09-07T09:45:05.000Z","updated_at":"2025-06-19T12:16:41.000Z","dependencies_parsed_at":"2025-01-16T04:42:48.877Z","dependency_job_id":"dc4634ce-d9f7-4f48-b5f3-e7c71eb18f75","html_url":"https://github.com/UNDP-Data/st-undp","commit_stats":null,"previous_names":["undp-data/st-undp"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/UNDP-Data/st-undp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UNDP-Data%2Fst-undp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UNDP-Data%2Fst-undp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UNDP-Data%2Fst-undp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UNDP-Data%2Fst-undp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UNDP-Data","download_url":"https://codeload.github.com/UNDP-Data/st-undp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UNDP-Data%2Fst-undp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33162446,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T22:39:12.733Z","status":"online","status_checked_at":"2026-05-18T02:00:06.436Z","response_time":71,"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":["data-futures-exchange","streamlit","streamlit-ui","undp","web-app"],"created_at":"2024-11-15T16:35:45.935Z","updated_at":"2026-05-18T02:03:00.556Z","avatar_url":"https://github.com/UNDP-Data.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# st-undp\n\n[![Build and deploy Python app to Azure Web App](https://github.com/undp-data/st-undp/actions/workflows/azure-webapps-python.yml/badge.svg)](https://github.com/undp-data/st-undp/actions/workflows/azure-webapps-python.yml)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/release/python-3110/)\n[![License](https://img.shields.io/github/license/undp-data/st-undp)](https://github.com/undp-data/st-undp/blob/main/LICENSE)\n[![Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Imports: isort](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat\u0026labelColor=ef8336)](https://pycqa.github.io/isort/)\n[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-%23FE5196?logo=conventionalcommits\u0026logoColor=white)](https://conventionalcommits.org)\n\nA utility package that styles Streamlit apps according to [UNDP Design System](https://design.undp.org).\nCheck out the [documentation](https://undp-data.github.io/st-undp) or explore this [live demo app](https://st-undp.azurewebsites.net).\n\n\u003e [!WARNING]  \n\u003e This project has been superceded by [`py-shiny-starter-kit`](https://github.com/UNDP-Data/py-shiny-starter-kit) which is now the recommended framework for developing data applications at UNDP. `st-undp` is archived and will recieve no updates.\n\n![Preview](docs/assets/images/preview.gif)\n\n## Table of Contents\n\n- [Installation](#installation)\n- [Usage](#usage)\n- [Features](#features)\n- [Contributing](#contributing)\n- [License](#license)\n- [Contact](#contact)\n\n## Installation\n\nCurrently, the package is distributed via GitHub only. You can install it with `pip`:\n\n```bash\n pip install git+https://github.com/undp-data/st-undp.git@0.1.0\n```\n\nYou can also add it to your `requirements.txt`:\n\n```requirements\nst-undp @ git+https://github.com/undp-data/st-undp.git@0.1.0\n```\n\nSee [VCS Support](https://pip.pypa.io/en/stable/topics/vcs-support/#vcs-support) for more details.\n\n## Usage\n\nThe package is intended to make styling a breeze. The most basic usage involves only two simple steps.\n\nFirst, use the CLI to set up the recommended theme in `.streamlit/config.toml`:\n\n```shell\npython -m st_undp configure\n```\n\nThis will edit the theme section in the file if it exists or create it if it doesn't.\nThen, call `apply_style` function inside your application entry point, typically `app.py`:\n\n```python\nimport st_undp\nimport streamlit as st\n\nst_undp.apply_style()\n\nst.title(\"Hello world!\")  # now UNDP-styled\n```\n\n## Features\n\nThis package is currently in the early stages of development. Main features include:\n\n- `ProximaNova` fonts\n- CSS styles for most Streamlit input components\n- Several custom components from the UNDP Design System, such as Author, Footer, Header, Stats Card\n- Custom UNDP themed for Plotly and ready-made Plotly charts.\n- No additional dependencies on top of what is required by `streamlit`\n\n## Contributing\n\nAll contributions must follow [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/).\nThe codebase is formatted with `black` and `isort`. Use the provided [Makefile](./Makefile) for these\nroutine operations.\n\n1. Clone or fork the repository\n2. Create a new branch (`git checkout -b feature-branch`)\n3. Make your changes\n4. Ensure your code is properly formatted (`make format`)\n5. Commit your changes (`git commit -m 'Add some feature'`)\n6. Push to the branch (`git push origin feature-branch`)\n7. Open a pull request\n\n## License\n\nThis project is licensed under the BSD 3-Clause License. However, entities or individuals not affiliated with UNDP\nare strictly prohibited from using this package or any of its components to create, share, publish, or distribute works\nthat resemble, claim affiliation with, or imply endorsement by UNDP.\n\nUNDP’s name, emblem and its abbreviation are the exclusive property of UNDP and are protected under international law.\nTheir unauthorized use is prohibited, and they may not be reproduced or used in any manner without UNDP’s prior written permission.\n\n## Contact\n\nThis project is part of [Data Futures Exchange (DFx)](https://data.undp.org) at UNDP.\nIf you are facing any issues or would like to make some suggestions, feel free to\n[open an issue](https://github.com/undp-data/st-undp/issues/new/choose).\nFor enquiries about DFx, visit [Contact Us](https://data.undp.org/contact-us).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fundp-data%2Fst-undp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fundp-data%2Fst-undp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fundp-data%2Fst-undp/lists"}