Laravel Hubspot Starter Kit

Overview

The Laravel HubSpot Starter Kit is a useful resource for developers who are building a public app for HubSpot. This starter kit provides a foundation for creating an app that integrates with the HubSpot platform. It includes various features such as Laravel, Vite, Vue with Vue Router, Pinia State Manager, Tailwind, Laravel Valet, Laravel Ziggy, and more. The kit also allows users to belong to multiple teams and add multiple portals. By following the provided installation guide, developers can easily set up the starter kit and start building their HubSpot app.

Features

• Laravel 9.x: The latest version of the Laravel framework is included in the starter kit.
• Vite 3.x: Vite is used as the build tool for the front-end assets.
• Vue 3.x with Vue Router: The kit utilizes Vue.js with Vue Router for building the front-end.
• Pinia State Manager: The Pinia state manager is included in the starter kit to manage state in the Vue app.
• Tailwind 3.x: The popular CSS framework, Tailwind, is included in the starter kit for easy styling and customization.
• Laravel Valet: Laravel Valet is used for local development and provides a simple way to link the working directory to a local domain.
• Laravel Ziggy: Laravel Ziggy is included to make working with Laravel routes in JavaScript easier.
• Integrated SPA: The starter kit utilizes a single-page application (SPA) architecture, where the Laravel API and Vue 3 front-end are served from the same server instance.
• Laravel Auth: Laravel’s built-in authentication system is integrated into the starter kit.
• HubSpot OAuth2 flow: The starter kit includes the necessary functionality to handle the OAuth2 authentication flow with HubSpot.
• Multi-team support: Users can belong to multiple teams within the app.
• Multi-portal support: Teams can add multiple portals to the app, allowing for integration with multiple HubSpot accounts.
• Procfile included: A Procfile is included in the starter kit, making it easy to deploy the app to Heroku.

Installation

To install the Laravel HubSpot Starter Kit, follow these steps:

1. Clone or fork the repository.
2. Open the terminal and navigate to the working directory (e.g., cd laravel-hubspot-starter-kit).
3. Run composer install to install the PHP dependencies.
4. Run yarn install or npm install to install the JavaScript dependencies.
5. Run valet link to link your working directory to a local domain (e.g., https://laravel-hubspot-starter-kit.dev/).
6. Secure your local API with valet secure. Note that HubSpot apps require HTTPS, except when testing with http://localhost.
7. Create your MySQL or MariaDB database.
8. Rename the .env.example file to .env in your working directory.
9. Update the .env file with your database credentials and set the APP_URL to https://laravel-hubspot-starter-kit.dev.
10. Save the .env file.
11. Run php artisan migrate to run the database migrations.
12. You should now be able to navigate to https://laravel-hubspot-starter-kit.dev/register in your browser and register as a new user. Please note that you may see a broken SSL in the browser during this step, but it is not a concern at this point as we have already secured the Laravel API.

Summary

The Laravel HubSpot Starter Kit provides a solid foundation for developers looking to build a public app for HubSpot. With features like Laravel, Vite, Vue with Vue Router, Pinia State Manager, and Tailwind, it offers a modern and efficient development experience. The kit also includes support for multi-team and multi-portal functionality, making it flexible for different use cases. By following the installation guide, developers can easily set up the starter kit and start building their HubSpot app with confidence.