{"id":22918227,"url":"https://github.com/stlbucket/phile-starter","last_synced_at":"2026-03-20T00:00:05.519Z","repository":{"id":39298201,"uuid":"197026823","full_name":"stlbucket/phile-starter","owner":"stlbucket","description":null,"archived":false,"fork":false,"pushed_at":"2023-01-04T04:33:52.000Z","size":6558,"stargazers_count":0,"open_issues_count":84,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-01T00:31:38.106Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PLpgSQL","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/stlbucket.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}},"created_at":"2019-07-15T15:37:09.000Z","updated_at":"2020-01-28T17:41:59.000Z","dependencies_parsed_at":"2023-02-01T21:00:20.867Z","dependency_job_id":null,"html_url":"https://github.com/stlbucket/phile-starter","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/stlbucket%2Fphile-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stlbucket%2Fphile-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stlbucket%2Fphile-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stlbucket%2Fphile-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stlbucket","download_url":"https://codeload.github.com/stlbucket/phile-starter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246644099,"owners_count":20810687,"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-12-14T06:29:27.260Z","updated_at":"2026-01-11T01:41:22.398Z","avatar_url":"https://github.com/stlbucket.png","language":"PLpgSQL","funding_links":[],"categories":[],"sub_categories":[],"readme":"# phile-starter \n\n## setup instructions\n\n### requirements\n\n- \u003ca href=\"https://nodejs.org/\"\u003enode\u003c/a\u003e\n  install v10 LTS or later\n- \u003ca href=\"https://yarnpkg.com/lang/en/docs/install\"\u003eyarn\u003c/a\u003e\n  you can use npm if you prefer, but as of the time of this writing, yarn is the package manager of choice \n  (this will all be rethought after the great package manager wars of 2020, no doubt...)\n- \u003ca href=\"https://www.docker.com/get-started\"\u003edocker\u003c/a\u003e\n  docker will make postgres easy to deal with\n- \u003ca href=\"https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html\"\u003eansible\u003c/a\u003e\n  ansible executes a series of commands to build the database \n\nalso, you will need to install at least the postgres client on your local machine.  there are a couple of ways to do this\n- install postgres outright, then disable the server (we are going to be using docker to run postgres in a container)\n    https://www.postgresql.org/download/\n- install only the client libraries. this method may be a bit less reliable depending on your environment\n    https://www.compose.com/articles/postgresql-tips-installing-the-postgresql-client/\n\nafter installing the above:\n\n```\ngit clone git@github.com:stlbucket/phile-starter.git\n\ncp ansible/config.ex.yml \u003e ansible/config.yml\n```\n\nyou need to edit the ansible/config.yml file to point the docker postgres script at your local pg10 data directory\n```\npg10_data_path: [PATH TO YOUR PG 10 DATA DIRECTORY]\nsqitch_target_local: db:pg://postgres:1234@0.0.0.0/phile_starter\n```\n\nthen\n```\nyarn devSetup\n```\n\nthis will create a shell script that will start the postgres docker image using the pg10 data directory from your ansible/config.yml\n\nrun this script to start your database server\n```\nyarn pg10\n```\n\nthe image will take a bit to spin up, maybe 30 sec.  you can run psql with the following:\n```\nyarn psql\n```\n\nif you are unfamiliar with the psql client, to quit just enter:\n```\n\\q\n```\n\nonce postgres is ready, as indicated by success of the psql connection, deploy the database\n\n```\nyarn dbDeployLocal\n```\n\n## directory structure\n\n### ansible\nansible-playbooks to aid in dev setup\n\n### api\nnode-postgraphile graphql server\n\n### az-config\nansible-playbooks to aid in setup on the azure platform\n\n### db\nscripts to define and manage the datbase using sqitch\n\n### web-vue\na starter web app that demonstrates login, row-level-security, app modules, and more.  could be basis for a new project or can be thrown away in favor of a different ui\n\n## running the server\nin a new terminal, go to the phile-starter/api directory\n\nfor local db\n```\nyarn\n\nyarn serve\n```\n\n## running the web app\nin a new terminal, go to the phile-starter/web-vue directory\n\n```\nyarn\n\nyarn serve\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstlbucket%2Fphile-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstlbucket%2Fphile-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstlbucket%2Fphile-starter/lists"}