https://github.com/mbpictures/tessera
Open source and ready to use ticket shop with lots of customization abilities and feature rich admin dashboard. Several payment providers (stripe, paypal, sofort) are available out of the box and new ones can be added with ease.
https://github.com/mbpictures/tessera
nextjs ready-to-use ticket-booking ticket-selling ticket-server
Last synced: about 1 month ago
JSON representation
Open source and ready to use ticket shop with lots of customization abilities and feature rich admin dashboard. Several payment providers (stripe, paypal, sofort) are available out of the box and new ones can be added with ease.
- Host: GitHub
- URL: https://github.com/mbpictures/tessera
- Owner: mbpictures
- License: mit
- Created: 2021-10-03T15:11:48.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-12-29T22:13:50.000Z (over 1 year ago)
- Last Synced: 2024-05-02T02:27:50.537Z (about 1 year ago)
- Topics: nextjs, ready-to-use, ticket-booking, ticket-selling, ticket-server
- Language: TypeScript
- Homepage:
- Size: 2.82 MB
- Stars: 13
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
Welcome to Tessera 👋
Your open source ticket shop
> Open source and ready to use ticket shop with lots of customization abilities and feature rich admin dashboard. Several payment providers (stripe, paypal, sofort) are available out of the box and new ones can be added with ease.
### 🏠 [Homepage](https://github.com/mbpictures/ticketshop#readme)
### ✨ [Demo](https://nextjs-ticketshop-demo.herokuapp.com/)
## ⚡️ Quickstart
### 📥 Install
```sh
npm install
```
### ▶️ Run
1. Create a ```.env``` file containing all values of [.env.example](.env.example) except the optional ones
2. Set up a database (further instructions [here](https://www.prisma.io/docs/getting-started/setup-prisma/start-from-scratch/relational-databases/connect-your-database-typescript-postgres))
3. If you're **not** using _postgresql_ please update the provider flag inside the [schema.prisma](prisma/schema.prisma)
4. Optional: Configure payment providers in ```.env``` (e.g. stripe, sofort, paypal)
5. Optional: Configure email service to send invoices and digital digits (e.g. gmail)
6. Push prisma db schema to your database and generate prisma client with:
```shell
prisma db push
prisma generate
```
7. (OPTIONAL) seed the database with demo configuration:
```shell
prisma db seed
```
8. Start the server at port 3000 using:
```shell
npm run build
npm run start:default
```
9. Open the ticketshop at the url in the console
10. Open the admin page at URL/admin
11. Create your first admin user with the register button (the first user is granted with admin permissions)
### 🐳 Setup Docker
1. Pull the image using ```docker pull ghcr.io/mbpictures/nextjs-ticketshop```
2. Create a container ```docker create --name nextjs-ticketshop -p 3000:3000 --add-host=host.docker.internal:host-gateway nextjs-ticketshop```
3. Update the host of your database URL to ```postgresql://USERNAME:[email protected]:PORT/DATABASE?schema=public``` if you want to use the database running on your host OS. If you want to use a database container, replace ```host.docker.internal``` by the name of your database container and add a docker network.
4. Copy your environments file inside the container: ```docker cp .env nextjs-ticketshop:/ticketshop/.env```
5. Start the container ```docker start nextjs-ticketshop```
6. You can access your ticketshop at ```http://localhost:3000```
## 🎯 Features
- Select events, seats and collect customer information (address, e-mail, etc)
- Three delivery possibilities: Download (Template Ticket with QR), Postal delivery and box office
- Payment: [PayPal](https://www.paypal.com/), [stripe](https://stripe.com) (iban & credit card), [sofort](https://www.klarna.com/sofort/) and invoice
- Sending emails (with templates) containing invoice and/or tickets
- Easy to use admin section with event management, seat map editor, viewing orders, marking invoices as payed
- RESTful API to manage events and orders with third party tools or webhooks
- Customizable ticket shop UI with import function for [MUI themes](https://mui.com/customization/theming/)
- Multi-Language Support and translation editor
- Ticket control webapp (to scan and verify downloaded tickets)
- Notifications (e.g. for new orders)
- Event scheduling
- [Google Wallet API](https://developers.google.com/wallet) for event tickets (needs environment variables)
### 🔜 Planned
- Customizeable webhooks (to automate receipt of payment detection etc.)
If you miss some features, which are not planned, please create an [issue ❗](https://github.com/mbpictures/tessera/issues)
## 👨💻 Tech stack
- This project uses [React](https://reactjs.org/) for frontend
- [MUI](https://mui.com/) as UI library
- [Next.JS](https://nextjs.org/) is used as WebSDK and as server backend
- All data is stored in a database (e.g. Postgre) and with [prisma](https://www.prisma.io/) as ORM accessed
- Integration testing is done with [cypress](https://www.cypress.io/)
- Continuous Integration using [GitHub Actions](https://github.com/features/actions)
## 📝 Documentation
You can find a detailed documentation [here](https://mbpictures.github.io/tessera/)
## 👥 Author
👤 **Marius Butz**
* Website: http://marius-butz.de
## ⭐️ Show your support
- Give a [⭐️ star](https://github.com/mbpictures/tessera) if this project helped you!
- Create a [🍴 fork](https://github.com/mbpictures/tessera) and contribute by fixing bugs or adding features