Build your empire of pixel badges. Show off your collection that reflects your personality and achievements. Participate in events or trade with others to grow your inventory (inspired by Holopin.io)
Visit the site »
Website
·
Issues
·
Hanko
Stampxl is an open-sourced project inspired by Holopin.io where you can collect and trade pixel badge collectibles. These are distributed through events or as easter-eggs. Some badges are tradeable, which means you can trade with other users to grow your collection and own badges that you have missed out on.
- Create Badges Organizations, maintainers, and recognized individuals can create badges that they can distribute as rewards or as giveaways.
- Collect Badges Users can collect badges by reedeming them through claim tokens/links that are distributed by the creators.
- Trade Badges Users can trade badges with other users, to grow their own collection or get rarer badges to that suits their personality.
- Passwordless Authentication Experience a seamless login experience with passwordless authentication with passkeys.
Are you now curious with our platform? Join us now, we're giving away free early-bird badges for the first 100 users!
Here is what you need to be able to run Stampxl.
- Node.js (Version: >=20.x)
- PostgreSQL
- Hanko Cloud
- PNPM (recommended)
-
Clone the repo into a public GitHub repository (or fork https://github.com/ShaneMaglangit/stampxl/fork).
git clone [email protected]:ShaneMaglangit/stampxl.git
-
Install dependencies
cd stampxl pnpm install
-
Setup environment variables by copying
.env.example
to.env
and filling in the values.mv .env.example .env
-
Initialize the database (make sure
DATABASE_URL
contains a valid database connection string)pnpm db:push
-
Run the development server
pnpm dev
- Go to https://cloud.hanko.io/ and setup a new account.
- Create a new project that will be linked to your local development environment.
- Open your project and go to
Settings > General
- Set
APP_URL
tohttp:https://localhost:3000
or your preferred port. - Copy
API_URL
and set it as the value ofNEXT_PUBLIC_HANKO_API_URL
in your.env
file.
- Set
- Create a new account by going to
/login
and completing the registration process. - Go to the
users
table in the database and addCREATOR
andADMIN
to your roles. 3.CREATOR
- allows you to create badges 4. We would add a script to automate this in the future. If you're interested in contributing, feel free to open a Pull Request
- Writing good commit messages
- We are yet to add determine conventions and style guidelines for the project. But we're open to suggestions and contributions.
You're all set! Visit our issues to start contributing.
Distributed under the GNU General Public License v3.0. See LICENSE.md
for more information.
Special thanks to these amazing projects which help power Stampxl: