Fresh App Factory

Fresh App Factory automatically generates template repositories from popular open-source app frameworks.

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:

<!-- prettier-ignore-start -->

| Approach | Pros and cons | | ----- | ----- | | Manually-maintained repos | <ul><li>➕ Can easily create a new repo by clicking on “Use this template” button.<li>➕ Can easily be used with tools like Codesandbox, Gitpod, or Stackblitz.<li>➖ Can easily become out-of-date<li>➖ Maintainers may forgot to mark repository as a template repository.</ul> | | Folder in monorepo | <ul><li>➕ Easier for maintainers to keep up-to-date.<li>➕ Can easily be used with tools like Codesandbox, Gitpod, or Stackblitz.<li>➖ Cannot use the “Use this template” button.<li>➖ Requires an extra step to copy a subdirectory into a new repo.</ul> | | Generator CLIs | <ul><li>➕ Can support a lot of combinations.<li>➕ Gives you an up-to-date app.<li>➖ Requires installing an extra CLI tool, whose installation process may be slow.<li>➖ Cannot easily use with Codesandbox, Gitpod, or Stackblitz.<li>➖ Cannot use the “Use this template” button.</ul> | | Fresh App Factory | <ul><li>➕ Up-to-date as the templates are generated from generator CLIs daily.<li>➕ Can easily create a new repo by clicking on “Use this template” button.<li>➕ Can easily be used with tools like Codesandbox, Gitpod, or Stackblitz.<li>➖ Supports only a few configurations.</ul> |

<!-- prettier-ignore-end -->

Development

Prerequisites

• Node.js and Corepack
• Docker

Setup

# 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