Manual Setup

Follow these steps to set up LaunchFast without using the automated npx -y launchfast@latest command. The automated installer is recommended for most users.

1. Get the template

After purchase, the installer delivers the LaunchFast template to your machine. If you already ran npx -y launchfast@latest and want to start fresh, the template is in the directory the installer created. Navigate into it:

cd my-app-name

2. Update app name

Update package.json with your app name:

{
  "name": "my-app-name"
}

Update fly.toml — replace all instances of launch-fast-template with your app name:

app = "my-app-name"
primary_region = "iad"

3. Set up environment variables

Create a .env file from the example:

cp .env.example .env

Generate random secrets and update SESSION_SECRET and INTERNAL_COMMAND_TOKEN in your .env file:

openssl rand -hex 16

Never commit your .env file to version control.

4. Configure git

git init
git branch -m main
cp remix.init/gitignore .gitignore

5. Clean up template files

rm LICENSE.md CONTRIBUTING.md

6. Install dependencies and initialize

npm install
npx prisma generate
npx prisma migrate deploy
npx prisma db seed
npx playwright install

7. Format code

npm run format

8. Test your setup

npm run dev
npm run validate

Open http://localhost:3000 in your browser to confirm the application is running.

9. Deploy to Fly.io (optional)

To deploy your app to production, follow the Fly.io deployment guide.

Troubleshooting

Database errors

If you encounter database issues, reset the database:

npx prisma migrate reset

This drops the database, runs all migrations, and re-seeds the data.

Port already in use

lsof -ti:3000 | xargs kill -9
# Or use a different port:
PORT=3001 npm run dev