DAY 1 DEVELOPER PORTAL

Onboarding Roadmap

Welcome to the Milesoft Developer Portal! This guide is designed to get your workspace set up, credentials verified, and your first Spring Boot application running in GCP — in under 30 minutes (once your cloud environment is provisioned and billing is active).

What is Milesoft?

Milesoft is an enterprise-grade application enablement platform. It combines automated cloud scaffolding with a powerful suite of SDK microservices and pre-built infrastructure integrations to eliminate boilerplate, maximize engineering velocity, and ensure strict production standards from day one.

Scaffold with Tenancy

Bootstrap Spring Boot + React projects configured instantly with strict multi-tenant isolation, data caching configs, and MapStruct mapping.

Automated GCP Setup

Provision cloud components (Secret Manager, Storage buckets, Cloud Run instances, Pub/Sub topics) with strict IAM roles in seconds.

Plug-and-Play SDKs

Connect programmatically to centralized services for Accounts (Identity), Contacts (Graph topologies), Gamification, Templates, and Messaging.

Unified Integrations

Instantly deploy pre-built bridges for Stripe card payments, Intuit QuickBooks accounting, Vertex AI cognitive pipelines, and Twilio gateways.

# Core Quickstart Milestones

Complete these four primary milestones in order to bring your local workstation online.

1

Prerequisites & Local Authentication

Est: 10 mins

Prepare your workspace tooling and authenticate your developer identities. This sets up the fundamental connections needed to access premium SDKs and secrets management.

1.1 System Tooling

Install Java (JDK 17+) and the Google Cloud CLI (`gcloud`).

1.2 Authenticate CLIs

Login to Milesoft CLI and authenticate Google Application Default Credentials (ADC).

# Install the Milesoft CLI & login
curl -fsSL https://milesoft.io/cli/install.sh | sh
milesoft login
# Authenticate with Google Cloud
gcloud auth login
gcloud auth application-default login
Read Milestone 1: Prerequisites Guide
2

Application Provisioning & Bootstrapping

Est: 10 mins

Initialize your Google Cloud project structure and scaffold your optimized Spring Boot microservice. The CLI handles API enabling, bucket setup, and code generation automatically.

2.1 Provision GCP APIs

Enables Secret Manager, Storage, Pub/Sub, and creates required IAM roles.

2.2 Scaffold Codebase

Downloads the Spring Boot blueprint complete with pre-configured gradle files.

# Connect your GCP project environment
milesoft init gcp --project "your-gcp-project-id"
# Bootstrap your Spring Boot microservice
milesoft init app
Read Milestone 2: Getting Started Guide
3

Cloud Deployment

Est: 5 mins

Build and package your containerized microservice, submitting it remote to Google Cloud Build. Deploy it live on Cloud Run, then update your environment variables.

3.1 Gcloud Deployment Pipeline

Submits your source with Cloud Build, compiling using the Dockerfile manifest.

3.2 Register Base URLs

Replaces the "TBD" parameters in http-client.env.json with your live service URL.

# Trigger build & deploy remote pipeline via terminal or IntelliJ README
gcloud builds submit --project gcp-project-id && \
gcloud run deploy app-name --project gcp-project-id ...
Read Milestone 3: Cloud Deployment Guide
4

Personal Access Tokens (PAT)

Est: 5 mins

Generate a secure Personal Access Token (PAT) using the Milesoft CLI. This token authenticates your HTTP requests against the platform gateways and secures interactions with your newly deployed Cloud Run service endpoints.

4.1 Generate a Key Nonce

Retrieve a secure administrative or developer PAT associated with your roles.

4.2 Configure Private Client Env

Place the token inside http-client.private.env.json for safe HTTP calls.

# Generate a developer/admin key nonce with required roles
milesoft key create --roles "ROLE_OPS,ROLE_GUEST"
Read Milestone 4: Personal Access Tokens (PAT)

Platform & Reference Concepts

Once your local setup is complete, use these comprehensive guides to expand your service capabilities and understand platform designs.

Architecture & Setup

Learn about Gateway propagation, multi-tenant network layers, and standard IAM setups in Google Cloud Platform.

Architecture | GCP Reference

SDKs & Libraries

Integrate custom business logic with robust clients for Accounts, Contacts, Games, Liquid templates, and shared primitives.

Explore SDKs & Libs

Artifact Registry & Cloud

Deep dive into secure Artifact Registry structures or configure Google Cloud Firestore, Pub/Sub, Storage, Task Queues, and Stripe.

Artifacts | Cloud Exts

Advanced How-To Guides

Ready to build? Learn how to customize, extend, and adapt the bootstrapped scaffold to meet your enterprise business requirements.

Customizing Your Application

A complete end-to-end tutorial on implementing custom Firestore entities, DTO wrappers, MapStruct mapping layers, service business logic, caching annotations, and RBAC rules.

Build Custom Feature

Extending Your Application

Discover the wider platform ecosystem. Review available platform Client SDKs and Cloud Infrastructure Extensions, and study real-world integration blueprints.

Explore SDKs & Extensions

Need assistance or hit a bump?

Our team is here to support you at every turn. If you run into issues with IAM roles, registry access, or local provisioning, let us help.

Get Support →