{"id":15314424,"url":"https://github.com/barelyhuman/preact-islands-fullstack-template","last_synced_at":"2025-04-15T02:13:10.830Z","repository":{"id":151362057,"uuid":"622176304","full_name":"barelyhuman/preact-islands-fullstack-template","owner":"barelyhuman","description":"Starter Template for fullstack apps with preact islands","archived":false,"fork":false,"pushed_at":"2023-10-17T06:53:28.000Z","size":96,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-15T02:12:59.605Z","etag":null,"topics":["islands","preact","preact-islands","starter","template"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/barelyhuman.png","metadata":{"files":{"readme":"readme.md","changelog":"CHANGELOG.md","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}},"created_at":"2023-04-01T10:52:46.000Z","updated_at":"2024-07-29T22:03:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"edcf4b32-fa8a-49bf-b174-27d4ccedb589","html_url":"https://github.com/barelyhuman/preact-islands-fullstack-template","commit_stats":null,"previous_names":[],"tags_count":1,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barelyhuman%2Fpreact-islands-fullstack-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barelyhuman%2Fpreact-islands-fullstack-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barelyhuman%2Fpreact-islands-fullstack-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barelyhuman%2Fpreact-islands-fullstack-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/barelyhuman","download_url":"https://codeload.github.com/barelyhuman/preact-islands-fullstack-template/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248991558,"owners_count":21194894,"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":["islands","preact","preact-islands","starter","template"],"created_at":"2024-10-01T08:45:27.261Z","updated_at":"2025-04-15T02:13:10.810Z","avatar_url":"https://github.com/barelyhuman.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# preact-islands-fullstack-template\n\n\u003e Starter Template for fullstack apps with preact islands\n\nA tiny base to start your full stack projects with, it's built with the DIY\nphilosophy so you are free to modify and build upon whatever is here in the\ntemplate. There are no opinions since it's just JS and no magic, other than\nmaybe the preact-island-plugin.\n\n\n## Reason \n\u003csmall\u003emore like, justification of its existence\u003c/small\u003e\n\nThe template is built as a more controlled replacement for something like [Astro](http://astro.build), not to compete but to be able to fix things yourself when needed instead. OSS devs work on various things and sometimes it's hard for them to take your issues on priority but then that doesn't mean that your project needs to be on halt either. \n\n- You can either fix, then raise a PR for whatever you think needs to be fixed. Which might not get merged, so you can maintain a fork a continue\n- Or, you can have a setup whose parts can be replaced as necessary and things are right there. \n\nI'm not against the 1st approach, I'm just more towards the 2nd one. \n\nThe template tries not to be opinionated but there are some additional utilities I've added for myself. To be fair, I'm probably the only one going to use this. \n\n## Stack\n\n- Express - HTTP Server\n- Preact + [esbuild version of preact-island-plugins](https://github.com/barelyhuman/preact-island-plugins) \n- Partial Hydration / Island Hydration Setup\n- Knex - Database Query Builder\n- TailwindCSS + PostCSS - Self Explanatory\n\n## Usage\n\n- Clone the repo and then make it your own. \n```\ngit clone git@github.com:barelyhuman/preact-islands-fullstack-template my-app\ncd my-app \nrm -rf .git \n\n# or do it all in one go \n$ npx degit barelyhuman/preact-islands-fullstack-template my-app\n```\n\n- The repo comes with `pnpm` as the package manager, if you wish to use `yarn` or `npm` \njust get rid of the `lock` file \n\n```sh\nrm pnpm-lock.yaml \n\n# then \nnpm i \n# or \nyarn install\n```\n\n- The `build.mjs` is responsible for combining and running all the moving parts, to better understand what's going on you can go through a [bare minimum setup](https://github.com/barelyhuman/preact-island-plugins/tree/main/examples/esbuild-express-web) \n\n\n## Directory Structure\n\nThe whole thing is divided into the following \n- `components`\n- `lib`\n- `pages`\n- `server` \n\nThe directories not mentioned here, `functions`, `database`, `migrations`, and `models` are all custom folders that I've added which I honestly don't use in a project, I'd move everything into an `src` directory but the template has it all on the root as to show all the parts out in the open\n\nEither way, you should be able to make sense of each of them by the name but just to be sure, the `server` and `lib` are what take care of the logic both for the rendering of the elements and `render-html.js` and serving the files.\n\nEverything is modifiable as mentioned in the [Reason](#reason) section, if the template is too opinionated, you can always start with one of the examples from [https://github.com/barelyhuman/preact-island-plugins](https://github.com/barelyhuman/preact-island-plugins)\n\n## License\n\nreaper Open Licensed\n\nFree to do whatever with it, there are no constraints, the `license` file is a\npart of the template to have an MIT starter and not a mandatory MIT base.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbarelyhuman%2Fpreact-islands-fullstack-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbarelyhuman%2Fpreact-islands-fullstack-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbarelyhuman%2Fpreact-islands-fullstack-template/lists"}