✨ Your new, shiny Nx workspace is almost ready ✨.

Learn more about this workspace setup and its capabilities or run bunx nx graph to visually explore what was created. Now, let's get you up to speed!

Live Demo: https://app.silver-elven.cc

Silver Elven is an event booking system that aims to provide a platform for hosting events, buying and selling tickets with a simple and easy-to-use user interface. This platform is focused on events that are open and do not require reservations that depend on seating arrangements. In other words, this is intended for a first-come first-served or General Admission events only.

This is a monorepo using Nx for running, testing and managing projects

• ebs-app: frontend web application
• api: web server API
• mobile: Android mobile application using Flutter

• Web Application: NextJS, TailwindCSS, Shadcn, Radix
• Web Server: Go using Gin framework
• Mobile App: Flutter (tested with Android only)
• Services integrated:
  • Stripe for Payments
  • AWS (ECS, EventBridge Scheduler, SQS, SNS, RDS, S3, ECR, SES)
  • Vercel for hosting the web app
  • Redis for caching
  • Firebase for user and authentication
  • Cloudflare for anti-spam and bot protection

• Host events
• Wait list
• Scheduled opening of registrations and start of admissions
• Buy and sell tickets
• Pay using Stripe
• QR code generation for tickets
• Includes mobile app for scanning and verifying QR code
• Download and share e-tickets
• Create multiple organizations
• Email notifications
• Social Auth
• Passwordless authentication with webauth and FIDO2
• View events in a calendar with Google Calendar

• sales calculation and dashboard
• Trending events page
• Transfer tickets
• Multi tenancy, RBAC
• Swagger API docs
• UI/UX improvements
• Proper icons, logo, etc.

• Events hosted are only for General Admission types.
• No seating arrangement planner

• This project currently undergoes heavy testing to ensure it becomes production-ready. If you like this project and plan to use it for commercial purposes feel free to fork this repo and set it up for production. Also a star would be much appreciated
• This is a personal project. I built this project so I can explore and learn more about other languages and frameworks specially on other platforms.
• The codebase needs some refactoring specially in the api since I am still learning about the best practices of writing Go code. There are parts that you might find a bit spaghetti-ish but I try to organize and break down the application into modules.
• Requests to the API must include x-secret and origin in the headers. This is a temporary protection layer for the request but does not guarantee data security against malicious attacks. Only use for testing purposes.
• Implement a more secure protection that adhere to web security standards to remove the need for such headers in a production environment.

Fork this repo and clone it

• Flutter - docs
• bun - docs
• nx CLI tool - docs
• stripe-mock - repo
• Firebase emulator suite for testing - docs
• PostgeSQL
• Redis
• Kafka - run docker-compose up using docker-compose.yml at the root of the repository
• Install atlas cli for gorm
• AWS account to use its services (ECS, EC2, ECR, SQS, SNS, S3, EventBridgeScheduler, etc.)

• for ebs-app install the dependencies with bun install
• cd into apps/api and run go mod tidy && go mod download
• cd into apps/mobile and run flutter pub get

• Run the scripts located at apps/api/scripts to manage migrations
• If you use AWS RDS, you need to set up the ECS containers, RDS cluster and EC2 instance in the same VPC which is the recommended way and more secure than exposing the database publicly.
• The EC2 instance will serve as the jumpbox for connecting to the RDS cluster from your local machine via SSH tunneling
• Usage of RDS is not required. You can use any cloud db provider such as Neon or Supabase.

To run the dev server for your app, use:

nx dev ebs-app

View app in browser:

http://localhost:3000

To run dev server for api, use:

nx serve api

Health check

curl http://localhost:9090

API available at /api/v1

To create a production bundle:

nx build ebs-app

nx build api

nx build mobile

To see all available targets to run for a project, run:

nx show project ebs-app

nx test ebs-app

nx test api

nx test mobile

• AWS services are used an integrated in the API. You need to have an account with root privileges
• You can delete fly.toml in the apps/api/ folder if you do not want to deploy to fly.io

• This project is not production-ready
• You need to have a live Stripe account
• You need to configure the release build of the mobile app if you wish to deploy to Play Store
• Only Android is configured to be built
• Need more testing

These targets are either inferred automatically or defined in the project.json or package.json files.

More about running tasks in the docs »

While you could add new projects to your workspace manually, you might want to leverage Nx plugins and their code generation feature.

Use the plugin's generator to create new projects.

You can use nx list to get a list of installed plugins. Then, run nx list <plugin-name> to learn about more specific capabilities of a particular plugin. Alternatively, install Nx Console to browse plugins and generators in your IDE.

Learn more about Nx plugins » | Browse the plugin registry »

Learn more about Nx on CI

Nx Console is an editor extension that enriches your developer experience. It lets you run tasks, generate code, and improves code autocompletion in your IDE. It is available for VSCode and IntelliJ.

Install Nx Console »

Learn more:

• Learn more about this workspace setup
• Learn about Nx on CI
• Releasing Packages with Nx release
• What are Nx plugins?

And join the Nx community:

• Discord
• Follow us on X or LinkedIn
• Our Youtube channel
• Our blog

MIT