{"id":16424105,"url":"https://github.com/funkatron/mirada","last_synced_at":"2026-02-02T13:11:37.990Z","repository":{"id":66389170,"uuid":"579474186","full_name":"funkatron/mirada","owner":"funkatron","description":"A simple Python-based web server to make front-end web development easier.","archived":false,"fork":false,"pushed_at":"2022-12-17T20:19:42.000Z","size":407,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-13T15:54:19.667Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/funkatron.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2022-12-17T20:17:28.000Z","updated_at":"2022-12-17T20:19:47.000Z","dependencies_parsed_at":"2023-03-14T10:00:20.099Z","dependency_job_id":null,"html_url":"https://github.com/funkatron/mirada","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/funkatron/mirada","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/funkatron%2Fmirada","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/funkatron%2Fmirada/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/funkatron%2Fmirada/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/funkatron%2Fmirada/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/funkatron","download_url":"https://codeload.github.com/funkatron/mirada/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/funkatron%2Fmirada/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29012691,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-02T12:48:30.580Z","status":"ssl_error","status_checked_at":"2026-02-02T12:46:38.384Z","response_time":58,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2024-10-11T07:43:07.349Z","updated_at":"2026-02-02T13:11:37.974Z","avatar_url":"https://github.com/funkatron.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mirada\n\nA web server to make front-end web development easier.\n\n## Motivation\n\nFront-end web development has become a cacophony of complex, brittle tooling. Modern, effective web development with \"Plain old HTML, CSS and JS\" (\"POHCJ\") can be relatively straightforward, and __should require little or no tooling__.\n\nStill, any tool is valuable for a project when the advantages make the added complexity wortwhile. Two areas where a tool would be useful in POHCJ:\n\n1. Web browsers have security features in place to limit what can be loaded from the local file system. Having a simple web server that the web browser can make requests to fixes this issue.\n2. HTML lacks any kind of code insertion or templating capabilities, which can mean a LOT of repeated code from file to file.\n\n## What Mirada does\n\nMirada is a Python-based web application meant to be run on your development machine (__never use this in production__). It aims to provide the following features:\n\n1. A simple web server to avoid security constraints on the local filesystem.\n2. An easy to use, but full-featured templating system, that allows for dynamic on-request rendering during development.\n3. WIP: Ability to write out static files, ready for deployment, with a single command.\n\n## Current limitations\n\n- Files that are not built on the fly must be served from the `/static/` directory and URI path\n\n## Start using Mirada\n\nWIP\n\n### What Goes Where\n\n- `_dist/`: Static builds of sites will be written here.\n- `mirada/`: The python application that powers the web server. You can ignore this.\n- `static/`: Anything not built from templates should be placed and served from here. This maps to the `/static/` URI path.\n- `templates/`: Jinja2 templates to render HTML to the browser when a request is made.\n    - `templates/layouts/`: Layouts for the pages to use.\n    - `templates/pages/`: Files that content page content.\n\n## Setup for Development _of_ Mirada\n\nWIP. Tested only on MacOS at this time.\n\n1. Install Python (3.7 or later)\n2. Clone this repo\n3. Open a Terminal window\n4. `cd` to the base directory of the repo\n5. Run `python3 -m venv ./venv`. Python will create a virtual environment in the `venv/` directory.\n6. Run `source ./venv/bin/activate` to activate the virtual environment.\n7. Run `pip install -r ./requirements.txt` to install project requirements.\n8. Run `flask run`.  It should start the flask dev server on port 5000.\n9. Visit http://0.0.0.0:5000.\n\n### Building\n\n1. `cd` to project base\n2. Run `source ./venv/bin/activate` to activate the virtual environment.\n3. Run `build-mirada-server.sh` (only on MacOS/Unices)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffunkatron%2Fmirada","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffunkatron%2Fmirada","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffunkatron%2Fmirada/lists"}