FoodTruckNerds Onboarding

Welcome to the FoodTruckNerds workspace! This guide will help you get set up and start contributing.

Quick Start

The easiest way to get started is using the Developer Setup GUI, a desktop application that automates the onboarding process.

  1. Download and run the Developer Setup GUI:

    • Windows: Download the latest .exe release

    • macOS: Download the .dmg or .app

    • Linux: Download .AppImage/.deb/.rpm

  2. Follow the setup wizard to:

    • Check prerequisites (Node.js, Corepack, pnpm)

    • Configure environment variables

    • Install project dependencies

    • Set up required service accounts

See Developer Setup GUI for detailed information about the app.

Prerequisites

Before you begin, ensure you have:

  • Node.js 22+ installed

  • Git configured

  • Access to the FoodTruckNerds GitHub organization

  • Accounts for required services (see below)

Required Services

You’ll need accounts for the following services:

The Developer Setup GUI will guide you through obtaining and configuring API keys for these services.

Workspace Structure

The FoodTruckNerds workspace contains multiple projects:

  • ftn-site-vercel — Main Next.js web application

  • setup-gui — Developer Setup GUI application (this repository)

  • Additional projects as they are added

Next Steps

After completing the initial setup:

  1. Project Templates: When starting a new project or updating workspace settings, browse the Standard Project Templates repository for industry-standard configurations and extension recommendations.

  2. Review project-specific documentation

  3. Familiarize yourself with the codebase

  4. Check out the development workflow

  5. Join team communication channels

Getting Help

If you run into issues during onboarding:

  1. Check the Developer Setup GUI documentation

  2. Review troubleshooting guides

  3. Ask in team channels

  4. Open an issue in the relevant repository