{"id":25969434,"url":"https://github.com/thesephi/fullstack-typescript-webapp-starter","last_synced_at":"2026-04-12T17:43:06.992Z","repository":{"id":55679314,"uuid":"297819014","full_name":"Thesephi/fullstack-typescript-webapp-starter","owner":"Thesephi","description":"A db-agnostic, React-based web application starter boilerplate","archived":false,"fork":false,"pushed_at":"2023-08-17T23:43:16.000Z","size":843,"stargazers_count":3,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-02T00:12:38.901Z","etag":null,"topics":["boilerplate","hacktoberfest","hacktoberfest2021","nodejs","reactjs","restify","somnus","typescript","webapp"],"latest_commit_sha":null,"homepage":"https://fullstack-ts-webapp-starter.herokuapp.com/","language":"TypeScript","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/Thesephi.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}},"created_at":"2020-09-23T01:33:51.000Z","updated_at":"2023-08-17T23:33:11.000Z","dependencies_parsed_at":"2022-08-15T06:20:33.520Z","dependency_job_id":null,"html_url":"https://github.com/Thesephi/fullstack-typescript-webapp-starter","commit_stats":null,"previous_names":[],"tags_count":4,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Thesephi%2Ffullstack-typescript-webapp-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Thesephi%2Ffullstack-typescript-webapp-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Thesephi%2Ffullstack-typescript-webapp-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Thesephi%2Ffullstack-typescript-webapp-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Thesephi","download_url":"https://codeload.github.com/Thesephi/fullstack-typescript-webapp-starter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241935238,"owners_count":20044826,"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":["boilerplate","hacktoberfest","hacktoberfest2021","nodejs","reactjs","restify","somnus","typescript","webapp"],"created_at":"2025-03-04T22:48:09.885Z","updated_at":"2026-04-12T17:43:06.934Z","avatar_url":"https://github.com/Thesephi.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Database-agnostic React-based full-stack web application starter boilerplate\n\n[![Build Status](https://travis-ci.com/Thesephi/fullstack-typescript-webapp-starter.svg?branch=master)](https://travis-ci.com/Thesephi/fullstack-typescript-webapp-starter)\n\nThis is an opinionated web app boilerplate that makes use of:\n- [React](https://reactjs.org/) on the client-side\n- [Somnus](https://github.com/somnusjs/somnus) on the server-side\n- [TypeScript](https://typescriptlang.org)\n- **no** database (*)\n\n(*) it does come with a simple \u0026 stupid mock database client, exposed as simple JavaScript functions, which you can replace with your database integration of choice (NoSQL, SQL, Graph, whatever floating your boat)\n\nAlso, there is **no** session management, OAuth, user management, or anything beyond basic, stateless REST endpoint routing and React views. If you are looking for a one-size-fits-all or a full-feature starter pack, this boilerplate is **not** for you.\n\n## Why this boilerplate\n\n- It stresses on minimalism and will not bundle more than the bare minimum needed to get your project up \u0026 running\n- Thanks to its minimalistic nature, it can be used as a core of a (traditional) monolithic app, or easily containerized \u0026 deployed as a microservice running in your architecture of choice (Docker Swarm, Kubernetes, etc.)\n- It is deploy-ready out-of-the-box e.g. on Heroku, and is especially suitable to create quick prototypes that are immediately shareable with the world\n\n## Why **not** this boilerplate\n\n- If you wish to avoid React in your stack\n- If you prefer the fuller-feature ExpressJS on the server-side\n- If you need a \"starter pack\" with authentication, session management, database integration or database related features such as ORM, or otherwise any feature **beyond** basic, stateless REST endpoint routing \u0026 React views\n\n## How to start the dev mode\n\n1. clone this project and `cd` into the project root directory\n2. run `npm install` (it'll take a while to download all frontend \u0026 backend libraries \u0026 DevTools)\n3. run `npm run dev` then follow the pointer from the console log\n\nChanges to the client-side or server-side code will be picked up automatically\n\n## How to generate the production build\n\n```bash\nNODE_ENV=production npm run build\n```\n\nWhen the script finishes, the server app should be available at `build/server/main.js`, which can be ran with `node` itself, or a Node.js-supported app-server / process-manager of choice (e.g. `pm2`, NGINX Unit, etc.)\n\n## How to test\n\nFrom the project root directory, run:\n```bash\nnpm test\n```\n\n## Environment Variables\n\n- `PORT`: if set, the app will be available on this port number; otherwise, a random port will be chosen\n\n## Caveats / TODOs\n\n- Source mapping doesn't work yet for the server app, and thus JS error logs are not pointing to the desirable line/column in the .ts files\n- The build is not yet optimized (output sizes larger than they could be in real production setups) ([#9](https://github.com/Thesephi/fullstack-typescript-webapp-starter/issues/9))\n- There is no example test suite yet for the backend part (REST endpoints)\n- The dev flow (`npm run dev`) has not been tested on platforms other than MacOS\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthesephi%2Ffullstack-typescript-webapp-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthesephi%2Ffullstack-typescript-webapp-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthesephi%2Ffullstack-typescript-webapp-starter/lists"}