Skip to content

feat: add manual testing infrastructure with example applications#20

Merged
dawidurbanski merged 12 commits into
mainfrom
16-manual-testing-setup
Sep 25, 2025
Merged

feat: add manual testing infrastructure with example applications#20
dawidurbanski merged 12 commits into
mainfrom
16-manual-testing-setup

Conversation

@dawidurbanski

Copy link
Copy Markdown
Owner

Summary

  • Add NextJS example application for manual testing of data layer integration
  • Create dev/start scripts to run packages alongside example frameworks
  • Configure workspaces and turbo to support example applications

Changes

This PR introduces a manual testing infrastructure that allows developers to test the data layer packages with real framework integrations. The setup enables running both the core packages and example applications simultaneously for integrated development and testing.

Key Features

  • NextJS Example App: A minimal NextJS application configured to test data layer integration
  • Development Scripts: New dev-with-framework.js and start-with-framework.js scripts for running packages + examples
  • Manual Testing Command: npm run test:manual nextjs to test specific frameworks
  • Workspace Configuration: Added examples/* to npm workspaces for proper package management
  • Enhanced Core Server: Improved startup with configuration loading and clearer console output

Usage

# Run all packages + NextJS example simultaneously
npm run dev -- --with-framework=nextjs

# Run manual tests for a specific framework
npm run test:manual nextjs

# Run production build with framework
npm run start -- --with-framework=nextjs

Test Plan

  • Verify NextJS example app starts successfully
  • Confirm packages and example run simultaneously with npm run dev -- --with-framework=nextjs
  • Test that regular npm run dev still works (packages only)
  • Ensure linting excludes examples directory
  • Validate workspace configuration recognizes example packages
  • Check that turbo properly orchestrates both packages and examples

Related Issues

Closes #16

Add instruction to run manual tests with example apps before
submitting PRs, ensuring integration changes are properly tested
Document available manual testing commands and framework support
for testing the data layer integration with example applications
Add examples folder to ESLint ignore patterns as example apps
may have their own linting configurations
- Add examples/* to npm workspaces
- Create dev/start scripts for framework integration
- Add test:manual command for testing specific frameworks
- Filter turbo commands to only run on packages by default
Configure manual testing task as persistent with no caching
to support continuous development testing with example apps
Add minimal NextJS application for manual testing of
data layer integration with framework-specific features
Add dev and start scripts to run example frameworks
alongside package development for integrated testing
Update scripts to use @examples/ prefix matching the
actual package names in workspace
Update dev/start scripts to run both packages and examples
when --with-framework is used, allowing simultaneous development
- Load user configuration from config files
- Support configurable port, host, and endpoint
- Add validation for port number
- Improve startup messages with GraphQL/GraphiQL URLs
Document the addition of example applications and testing
scripts as a minor version bump for the core package
@dawidurbanski dawidurbanski linked an issue Sep 25, 2025 that may be closed by this pull request
- Add dedicated test-manual.js script to handle framework argument
- Fix npm run test:manual command to properly accept framework parameter
- Now supports: npm run test:manual nextjs
@dawidurbanski dawidurbanski merged commit b50af26 into main Sep 25, 2025
4 checks passed
@dawidurbanski dawidurbanski deleted the 16-manual-testing-setup branch October 6, 2025 19:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Manual testing setup

1 participant