smail.aberkaoui
  • Home
  • Experiences
  • Projects
  • About

Pynspel

> Links
> Description
Pynspel is an open-source full-stack monorepo platform for building production-grade. Originally built as a commercial SaaS, it includes a feature-rich bot runtime (Discord.js), a performant REST API (Express.js), and a modern, admin dashboard (Next.js). OAuth-based authentication, and Stripe-powered billing, the system emphasizes modularity, type safety, and developer experience. Shared Zod schemas, Redis caching, PostgreSQL persistence, and WebSockets ensure scalable and dynamic server management.
> Goals
  • Enable scalable and production-ready Discord bot automation across multiple servers.
  • Provide a fully modular architecture for isolated bot feature lifecycles.
  • Ensure full-stack type safety and consistent validation using shared schemas.
  • Support user authentication, permission control, and billing integrations for SaaS use cases.
> Features
  • Modular system architecture: Each bot feature is a self-contained module with its own lifecycle, isolated state, and independent configuration.
  • Full-stack type safety: TypeScript and Zod schemas are shared across frontend, backend, and runtime for end-to-end consistency and better DX.
  • OAuth2 authentication & RBAC: Users authenticate via Auth0 with Discord OAuth, and are assigned roles with fine-grained dashboard permissions.
  • Stripe billing integration: Seamless Stripe integration for subscription-based monetization, webhook-driven feature toggling, and usage tracking.
  • Caching & performance optimization: Redis is used to cache frequently accessed guild settings, reducing database reads and improving response times.
  • Robust observability & error handling: Includes structured logging, alerting hooks, and unified error boundaries across services to ensure uptime and traceability.
  • Developer-first tooling: Monorepo structure using Turborepo and PNPM, with isolated packages, clean DX, and CI-ready workflows.
> Tech Stack
  • TypeScript
  • Next.js
  • React
  • Express.js
  • PostgreSQL
  • Redis
  • Discord.js
  • Zod
  • Stripe
  • OAuth (Auth0)
  • WebSocket
  • Turborepo
  • PNPM
  • Vitest
  • Tsup
  • React Query
  • Recoil
  • PandaCSS
> Learning Outcomes
  • Architected a full-stack project.
  • Implemented Redis-based caching to improve performance and reduce database load.
  • Built a secure authentication flow using Discord OAuth2 and Auth0 integration.
  • Integrated Stripe to support billing flows, webhook events, and access control via subscription tiers.
  • Adopted a monorepo workflow using Turborepo and PNPM for optimized DX and build performance.
  • Set up CI/CD pipelines for deployment previews, environment separation, and automated testing.
  • Designed a plugin-style module system for clean scalability and independent feature deployment.
  • Developed observability strategies using structured logs and centralized error handling.
  • Optimized UI responsiveness with React Query, optimistic updates, and schema-based UI state validation.