Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fresh-app/factory
We produce freshly-baked apps every midnight
https://github.com/fresh-app/factory
hacktoberfest nodejs typescript
Last synced: 8 days ago
JSON representation
We produce freshly-baked apps every midnight
- Host: GitHub
- URL: https://github.com/fresh-app/factory
- Owner: fresh-app
- License: mit
- Created: 2021-01-06T13:52:11.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-08-27T20:53:05.000Z (4 months ago)
- Last Synced: 2024-08-27T22:37:46.089Z (4 months ago)
- Topics: hacktoberfest, nodejs, typescript
- Language: TypeScript
- Homepage: https://fresh-app.github.io/
- Size: 62 MB
- Stars: 20
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - fresh-app/factory - We produce freshly-baked apps every midnight (TypeScript)
README
# Fresh App Factory
**[Fresh App Factory](https://fresh-app.github.io/)** automatically generates template repositories from popular open-source app frameworks.
[](https://fresh-app.github.io)
## Why?
This project aims to make it easier for developers to get started with new app frameworks. To understand how, let’s compare the different approaches:
| Approach | Pros and cons |
| ----- | ----- |
| **Manually-maintained repos** |
- ➕ Can easily create a new repo by clicking on “Use this template” button.
- ➕ Can easily be used with tools like [Codesandbox][], [Gitpod][], or [Stackblitz][].
- ➖ Can easily become out-of-date
- ➖ Maintainers may forgot to mark repository as a template repository.
| **Folder in monorepo** |
- ➕ Easier for maintainers to keep up-to-date.
- ➕ Can easily be used with tools like [Codesandbox][], [Gitpod][], or [Stackblitz][].
- ➖ Cannot use the “Use this template” button.
- ➖ Requires an extra step to copy a subdirectory into a new repo.
| **Generator CLIs** |
- ➕ Can support a lot of combinations.
- ➕ Gives you an up-to-date app.
- ➖ Requires installing an extra CLI tool, whose installation process may be slow.
- ➖ Cannot easily use with [Codesandbox][], [Gitpod][], or [Stackblitz][].
- ➖ Cannot use the “Use this template” button.
| **Fresh App Factory** |
- ➕ Up-to-date as the templates are generated from generator CLIs daily.
- ➕ Can easily create a new repo by clicking on “Use this template” button.
- ➕ Can easily be used with tools like [Codesandbox][], [Gitpod][], or [Stackblitz][].
- ➖ Supports only a few configurations.
[codesandbox]: https://codesandbox.io/
[gitpod]: https://www.gitpod.io/
[stackblitz]: https://stackblitz.com/
## Development
### Prerequisites
- Node.js and Corepack
- Docker
### Setup
```sh
# Install dependencies
pnpm install
# Build docker image
bin/build
# Run a generator
# Tip: when opening a generator in VS Code, you can press Cmd+Shift+B to run it
bin/run fresh-vite-app
# Run an interactive shell to inspect runner state
bin/inspect
# Run the factory on GitHub Actions
gh --repo fresh-app/factory workflow run manual.yml -f generator=fresh-vite-app
```