SocialPass provides end-to-end event organization software aimed at the next generation of events.
- Organizer Dashboard: Create and manage events, tickets, and live stats.
- Team-based Accounts: Invite team members and collaborate on events
- Messaging: Send email messages to ticket holders directly from the dashboard.
- Ticket Scanner: Scan tickets quickly, no account or download required.
- Ticket Types: Choose from paid, token-gated, or free tickets.
- Waitlist: Manage demand by allowing customers to join a waitlist and approve accordingly.
- RSVP: Create and send tickets to customers directly from the dashboard
- Scheduled Sales: Set specific start and end times for ticket availability.
- Ticket Delivery: Offer Google Wallet, Apple Wallet, and PNG options.
- Modern UI: Responsive, accessible, with light and dark modes.
- Great UX: Optimized for both customers and organizers.
- White-label Support: Customize colors, fonts, and branding product-wide AND team-wide.
- Localization: Fully adaptable to any language of choice.
- Custom Integrations: Tailor third-party integrations as needed. See our self hosting guide for more information.
The core of SocialPass consists of three parts:
- Organizer dashboard - Used by organizers to create and manage events
- Checkout - Used by attendees to get tickets for events
- Scanner - Used by organizers to check-in users by scanning the attendees' tickets
# Install python 3.10.5 version
pyenv install 3.10.5
# Make python version local or global
pyenv local 3.10.5
pyenv global 3.10.5
# Optional: Depending on your OS, you may need to run the following to activate pyenv
eval "$(pyenv init -)"
# Verify version
python --version
# Create a virtual enviroment for the application
pyenv virtualenv 3.10.5 socialpass
pyenv activate socialpass
# Install development dependencies
pip install -r config/requirements/local.txt
# Run Postgres server locally and create database with creds from settings
# Example using: https://postgresapp.com/
psql
create database local_socialpass_db;
\q
# Run migrations (if necessary)
python manage.py migrate
# Run application
make run
If you have a fairly latest version of Python 3 installed on your machine, you can just directly create a virtual environment and start SocialPass that way. All the instructions above (after the pyenv) section will still apply in such a case:
# Create a virtual enviroment for the application
virtualenv -p python3 venv
source venv/bin/activate
# Install development dependencies
pip install -r config/requirements/local.txt
# Run Postgres server locally and create database with creds from settings
# Example using: https://postgresapp.com/
psql
create database local_socialpass_db;
\q
# Run migrations (if necessary)
python manage.py migrate
# Run application
make run
There is a weird issue on Mac M1s that stems from the cryptography
package. In order to get SocialPass running on your M1, please follow these instructions:
- Remove
git+https://github.com/SocialPass/passbook.git@7a3614e974c1862a24e7b02ced11313c8320c14b
fromconfig/requirements/base.txt
and uninstall the package in your environment - Install
pip install [email protected]:devartis/passbook.git
instead - Install Homebrew: https://brew.sh/
- Install M2Crypto using the following instructions:
brew install openssl swig
LDFLAGS="-L$(brew --prefix openssl)/lib" CFLAGS="-I$(brew --prefix openssl)/include" SWIG_FEATURES="-I$(brew --prefix openssl)/include" pip install m2crypto
After that, you should be able to run your migrations and start the app.
Please always run the following commands to lint and format your codebase to make sure your PR passes the checks:
make lint
make format
- Branches opened for PR with relevant reviewer requested
- PR passes all checks
- PR reviewed
- PR merged into
master
or whatever is the working base at that moment
Once merged, master
, can be pushed directly to either staging
or production
.
This will trigger CI/CD pipeline for the respective environments.
Branches should be prefixed matching their corresponding GH label and a brief description of the issue at hand.
minor/*
major/*
refactor/*
bug/*
© 2024, SocialPass. All rights reserved