Skip to Content
Day 1.5: Pre-DevelopmentTech Stack Guide

Tech Stack Guide

Reference information for technology choices when building your project. Mentors will provide advice during Day 2’s “what to build” discussion or in the Slack channel beforehand.


Servers & Hosting

Choose an appropriate hosting service based on your project’s purpose.

Company/Work Projects

For work tools, select services that comply with your company’s security policies.

ServiceFeaturesBest For
HerokuEasy setup, good documentationInternal tools, prototypes
Google Cloud Platform (GCP)High reliability, rich featuresProduction business systems
VercelFrontend-focused, easy deploymentWeb apps, dashboards
AWSMost comprehensive servicesLarge-scale systems

Personal Projects

For personal tools, services with free tiers are recommended.

ServiceFree TierFeatures
VercelHobby plan (free)Excellent Next.js integration, easy deploy. Note: private repos require the Pro plan (paid)
GCP Always FreeMonthly quota free foreverPermanent free tier, wide range of services
Cloudflare PagesFreeStatic sites & web apps
Railway$5/month free creditPopular Heroku alternative
RenderFree tier availableGood for simple setups

At Flagship, we use Nest.js as the foundation for applications with server-side processing.

LayerTechnologyReason
BackendNest.js (TypeScript)Structured architecture, TypeScript by default
FrontendNext.js / ReactVercel compatibility, rich ecosystem
DatabasePostgreSQLReliability, Supabase integration
ORMPrismaType-safe, migration management

Frontend Only (Static Sites / SPA)

Next.js + Vercel

If you don’t need server-side processing, this is sufficient.

With Server-Side Processing

Next.js (frontend) + Nest.js (API) + PostgreSQL

Use this when you need authentication, database operations, or external API integration.

Simple Scripts & Automation

Python

Ideal for data processing, file operations, and scheduled tasks.


AI-Compatible Languages & Frameworks

The following languages and frameworks work especially well with Claude Code.

High Compatibility

Language/FWReason
PythonSimple syntax, rich libraries, AI/ML standard
TypeScriptType information helps Claude generate accurate code
Next.jsClear structure, extensive documentation
ReactEasy to give component-level instructions

Why These Work Well

  1. Rich Documentation: Claude’s training data includes many code samples
  2. Simple Syntax: Less complex notation, generated code is readable
  3. Type Information: Languages like TypeScript help Claude generate more accurate code
  4. Large Community: Solutions for errors and best practices are easy to find

When Compatibility is Challenging

More detailed instructions may be needed for:

  • Very new frameworks: Features released after 2024
  • Niche languages/libraries: Those with limited documentation
  • Complex configurations: Detailed Webpack/Vite settings

Database Recommendation

Why PostgreSQL

We recommend PostgreSQL as your database for the workshop.

Selection Reasons:

  1. Reliability: Years of proven track record, enterprise adoption
  2. Rich Features: JSON type, full-text search, geospatial data
  3. Supabase Integration: Free-to-start BaaS (Backend as a Service)
  4. AI Support: Vector search with pgvector (useful for RAG)
  5. Learning Curve: Close to SQL standard, easy migration to other DBs

Supabase Recommendation

Supabase is a PostgreSQL-based BaaS with these free features:

FeatureDescription
DatabasePostgreSQL database (up to 500MB free)
AuthUser authentication (email, OAuth)
StorageFile storage (up to 1GB free)
RealtimeReal-time data sync
Edge FunctionsServerless functions

Getting Started:

  1. Create an account at Supabase 
  2. Create a project (Tokyo region recommended)
  3. Copy connection info and configure your app

Other Database Options

DBUse CaseFeatures
SQLiteLocal development, small toolsFile-based, no setup needed
MongoDBDocument-style dataSchemaless, stores JSON directly
FirebaseMobile appsReal-time sync, Google integration

When You’re Unsure About Tech Choices

Consult with Mentors

Mentors will advise during Day 2’s “what to build” discussion. You can also ask in the Slack channel beforehand.

When asking, please share:

  • What you want to build: Purpose and features
  • Usage: Work or personal
  • Users: Just you or team use
  • Duration: Temporary or long-term operation

Start Simple

Avoid complex setups at first - start simple:

  1. Start with frontend only to build something that works
  2. Add Supabase when you need a database
  3. Add an API when you need server-side processing

Gradually adding features is the most efficient approach when developing with Claude Code.


Next Steps

Once you’ve decided on your tech stack, check out the Sample Templates for similar project examples.

Last updated on