La incr factory

A collection of interconnected incremental games built with Next.js and deployed on GitHub Pages.

Raise adorable Tamas on your virtual ranch! A comprehensive creature care and ranch management game featuring:

• Complete Care System: Feed, play, clean, and rest your Tamas to meet their needs
• Skills & Specialization: Choose between Caretaker, Breeder, or Entrepreneur paths
• Progressive Unlocks: Buildings, crafting, contracts, and prestige system
• Interactive Tutorial: 5-step guided onboarding for new players
• Smart Guidance: Next goal indicators show exactly what to do
• Full Test Coverage: 149+ automated tests ensure stability

Debug Console Available: Open browser console and type debug.help() for testing commands

TODO: DEVELOP BERGHAIN INCREMENTAL

Build a specialty coffee empire in Amsterdam! Start with a small café and grow into a coffee culture influencer. Features:

• Resource Management: Coffee beans, money, reputation, knowledge, and more
• Customer Education: Teach different neighborhood segments about specialty coffee
• James Hoffman Wisdom: Learn from the coffee master
• Progressive UI: Even the upgrades menu needs to be unlocked!
• Nook Coffee Supplies: Navigate business relationships with a certain raccoon
• Neighborhood Dynamics: Watch as your success changes the area around you

Livecoding as an idle game 🎛️🎮

• Play Game: StrudleIdle
• GitHub: https://github.com/PLNech/StrudleIdle

En 2025, plus tu codes, moins tu codes.

• Play Game: Le Dernier Code
• GitHub: https://github.com/plnech/DernierCode

Manage a network of information and watch it spread. Make strategic decisions to control the narrative and achieve global influence.

• Play Game: Propagation Inc.
• GitHub: https://github.com/PLNech/Propagation

1. Create a new repository named incr (or whatever you prefer)
2. Enable GitHub Pages in repository settings
3. Set source to "GitHub Actions"

Create these files in your repository:

incr/
├── package.json
├── next.config.js
├── tsconfig.json
├── tailwind.config.js
├── .github/
│   └── workflows/
│       └── deploy.yml
├── app/
│   ├── layout.tsx
│   ├── page.tsx
│   ├── globals.css
│   └── slow-roast/
│       └── page.tsx
└── lib/
    └── gameStateManager.ts

Using GitHub.dev (Browser-only):

1. Go to your repository
2. Press . to open GitHub.dev
3. Copy all the artifact files into the correct locations
4. Commit and push changes
5. GitHub Actions will automatically build and deploy

Local Development:

npm install
npm run dev

Build for Production:

npm run build
npm run export

1. In your repository, go to Settings → Pages
2. Set Source to "GitHub Actions"
3. The workflow will automatically deploy on every push to main

Once deployed, your games will be available at:

• https://yourusername.github.io/incr/ - Game selection hub
• https://yourusername.github.io/incr/slow-roast/ - Coffee shop game

• Shared Storage: Games can access each other's progress
• Global Achievements: Unlock bonuses across all games
• Progressive Unlocks: Complete one game to unlock the next
• Persistent Identity: Your name and progress carry forward

• No External Dependencies: Everything runs in the browser
• Auto-save: Games save progress automatically
• Export/Import: Backup and restore your progress
• Cross-Game Integration: Games can reference each other's data

To add a new game to the framework:

1. Create a new directory in app/your-game-name/
2. Add the game info to the GAMES array in app/page.tsx
3. Use the GameStateManager for persistence:

   import { GameStateManager } from '../../lib/gameStateManager';
   
   const gsm = GameStateManager.getInstance();
   gsm.saveGameState('your-game-id', gameData);
   const savedData = gsm.loadGameState('your-game-id');

• Next.js 14: React framework with App Router
• TypeScript: Type safety throughout
• Tailwind CSS: Utility-first styling
• Local Storage: Client-side persistence
• GitHub Actions: Automated deployment
• Static Export: Optimized for GitHub Pages

• No Server Required: Everything runs client-side
• Mobile Friendly: Responsive design for all screen sizes
• Offline Capable: Games work without internet after initial load
• Performance: Optimized builds with static generation

For developers and testers, Tama Bokujō includes a comprehensive debug console accessible via browser developer tools:

// Open browser console (F12) and use these commands:

// Quick progression shortcuts
debug.skipToMidGame()       // Jump to level 15 with boosted resources
debug.skipToLateGame()      // Jump to level 40 with elite setup
debug.prepareForPrestige()  // Setup conditions for first prestige

// Manual adjustments
debug.addXP(1000)           // Add experience points
debug.setLevel(25)          // Set player level directly
debug.addSkillPoints(50)    // Add skill points for testing skills
debug.addCoins(10000)       // Add Tama coins
debug.addAllResources(1000) // Add all resources with multiplier

// Tama management
debug.boostAllTamas()       // Max out all current Tamas
debug.createSuperTama('EliteTama') // Create level 25, tier 3 Tama

// Utility commands
debug.showGameState()       // Display current progress
debug.help()                // Show all available commands
debug.resetGame()           // Reset everything (with confirmation)

Access Methods:

• Type debug.help() or tamaDebug.help() in browser console
• Console automatically announces availability when game loads
• Available only in Tama Bokujō game page

Use Cases:

• Test late game mechanics without grinding
• QA testing of progression systems
• Content creator demonstrations
• Bug reproduction and testing

Each game should follow these principles:

• Start Simple: Begin with minimal mechanics, add complexity gradually
• Progressive Disclosure: UI elements unlock as player progresses
• Cross-Game Awareness: Check for achievements/progress in other games
• Thematic Coherence: Games should feel connected to the broader world

The Incremental Games Factory focuses on:

1. Meaningful Progression: Every action should feel purposeful
2. Interconnected Systems: Games reference and unlock each other
3. Social Commentary: Games can explore themes through mechanics
4. Automation Balance: Manual play that gradually becomes hands-off
5. Discovery: Let players uncover mechanics organically

Happy building! ☕🏭