A collection of example applications and starter templates for building ikas Admin apps. These examples demonstrate best practices, common patterns, and integrations for developing apps within the ikas ecosystem.
Starter App - Next.js 15 Full-Stack Template
Modern Next.js 15 App Router starter for building ikas Admin apps
Features:
- ⚛️ Next.js 15 + App Router with React 19 and TypeScript
- 🔐 OAuth for ikas - Complete end-to-end authorization flow
- 📡 Admin GraphQL client -
@ikas/admin-api-clientwith code generation - 🗃️ Prisma - Local development database for token storage
- 🎨 Tailwind CSS v4 + shadcn/ui - Modern component library
- 🔒 Iron Session - Secure server-side session management
- 🌉 Frontend ↔ Backend bridge - Typed API helpers and authentication
Perfect for: Full-stack ikas apps requiring authentication, database storage, and modern UI components.
- Node.js 18+ (LTS recommended)
- pnpm (preferred) or npm/yarn
- ikas Developer Account with app credentials
-
Clone the repository
git clone https://github.com/ikascom/ikas-app-examples.git cd ikas-app-examples -
Choose an example
cd examples/starter-app # or any other example
-
Follow the example's README
Each example includes detailed setup instructions, configuration guides, and usage examples.
These examples cover essential patterns for ikas app development:
- Authentication & OAuth - Secure user authorization flows
- GraphQL Integration - Type-safe API interactions with code generation
- Token Management - Secure storage and refresh patterns
- Session Handling - Server-side session management
- UI Components - Modern, accessible interfaces with Tailwind + shadcn/ui
- Database Integration - Local development with Prisma
- Security Best Practices - Token security, session management, and API protection
All examples follow these core principles:
- Type Safety First - TypeScript throughout with strict configuration
- Security by Default - Never expose tokens, secure session management
- Developer Experience - Hot reload, code generation, modern tooling
- Production Ready - Optimized builds, proper error handling
- ikas Standards - Consistent with ikas platform conventions
Most examples require these environment variables:
# ikas Configuration
NEXT_PUBLIC_GRAPH_API_URL=https://api.myikas.com/api/v2/admin/graphql
NEXT_PUBLIC_ADMIN_URL=https://{storeName}.myikas.com/admin
NEXT_PUBLIC_CLIENT_ID=your_ikas_app_client_id
CLIENT_SECRET=your_ikas_app_client_secret
NEXT_PUBLIC_DEPLOY_URL=https://yourapp.example.com
# Session Security
SECRET_COOKIE_PASSWORD=your_long_random_string_for_session_encryption- Use ikas MCP tools to discover available operations
- Add queries/mutations to
graphql-requests.ts - Run code generation:
pnpm codegen - Use typed client in your app
- Use shadcn MCP to discover components
- Install via CLI or copy from examples
- Customize with Tailwind classes
- OAuth authorization → token exchange → session storage
- JWT for frontend ↔ backend communication
- Automatic token refresh with
onCheckToken
We welcome contributions! Please follow these guidelines:
Use Conventional Commits format:
<type>(<scope>): <short summary>
Examples:
feat(starter): add user profile component
fix(auth): prevent token refresh loop
docs(readme): update installation guide
- TypeScript strict mode - No
anytypes - ESLint + Prettier - Consistent formatting
- Type safety - Prefer generated types over manual definitions
- Security first - Never log tokens or secrets
- Create new directory under
examples/ - Include comprehensive README with setup instructions
- Follow existing patterns for configuration and structure
- Update this main README with new example details
- ikas Developer Documentation
- ikas Admin GraphQL API
- Next.js Documentation
- Prisma Documentation
- Tailwind CSS
- shadcn/ui
MIT
- Bug Reports: GitHub Issues
- Feature Requests: GitHub Discussions
- Questions: ikas Developer Community
Happy coding! 🚀 Build amazing ikas apps with these examples as your foundation.