The Vision – A Forkable Social Metaverse
We’re building a forkable, non-profit template for a new social network and metaverse. Its core is a lightweight governance portal—a React 18 + Vite frontend and a FastAPI backend—that allows each community to self-govern with proposals, species-weighted votes, and symbolic metrics (Harmony, Resonance).
Access AI will be the first to implement this stack for our own new companies, providing a foundation for them to operate autonomously. Your mission is to integrate our existing components, polish the experience, and ship a V1 that we and others can easily fork. As a founder-led project, the code is independent and for everyone—we prioritize quality and usability over hype. (No crypto, no equity – just a cool project.)
Repos – Your Source of Truth
- Frontend: BP-H/alpha-j (React 18, TypeScript, Vite, plus image and AI demo integrations)
- Backend: BP-H/supernova-2177-ui-weighted (FastAPI, SQLAlchemy, Pydantic, Streamlit/NiceGUI hybrid UI, SQLite/Postgres modes)
V1 Scope – Additive enhancements only
- Governance Pages: Implement React pages for Proposals, Voting/Tally (with live weighted counts, prevent duplicate votes), Decisions, and Runs – using existing backend logic.
- Unified API Endpoints: Ensure all needed FastAPI endpoints are exposed under a single /api/* namespace. (E.g. wrap or alias existing routes like /resonance-summary as /api/resonance-summary for consistency, add /api/status and /api/ready health checks.) No new business logic – just expose what’s there and make minor tweaks (e.g. add one /api/proposals route).
- Responsive & Fast UI: Fix the current UI’s scaling issues (it should look great on mobile and desktop, no weird scroll/overflow). Use modern CSS (Flex/Grid, clamp(), etc.) so the design is fluid. Improve perceived performance with easy wins like code-splitting heavy components, optimizing image loads, and caching repeat requests.
- Settings Panel: Add a frontend sidebar panel to toggle “Use Live Backend” and set VITE_API_URL (similar to the existing Streamlit’s switch for demo mode vs. real backend). Persist these settings in localStorage.
- Hardening & Ops: Add env-driven CORS (no wildcards, use an allowlist), support switching between SQLite and Postgres via a DB_MODE env, and require a JWT auth token for write actions (if AUTH_ENABLED=true). Provide a Docker setup (Compose file) for one-command launch, a script to seed demo data, and a GitHub Actions check to keep the frontend SDK in sync with the API schema.
Your Experience
- FastAPI & Python: Significant experience with FastAPI, SQLAlchemy (Postgres), and Pydantic.
- React & Frontend: Fluent in modern React (Hooks, Context), TypeScript, and Vite.
- CSS & Responsiveness: Able to diagnose and fix complex CSS scaling issues using Flexbox, Grid, clamp(), etc.
- DevOps Mindset: Comfortable with Docker, Makefiles, and basic CI (e.g., GitHub Actions).
- Additive Coder: You enhance and refactor in-place, prioritizing clarity for future forkers over rewriting.
Nice-to-Have: Experience with Streamlit or NiceGUI, since you’ll be mimicking features that currently live there. Also, an eye for design/accessibility never hurts (we aim for at least AA compliance and <0.1 CLS).
Why This Project?
You’ll be shipping code that’s immediately used by multiple communities. It’s a short-term contract, but with long-term impact and the possibility of follow-on work. The project is fully open-source, and backed by a small, mission-driven team. No bureaucracy – you’ll have direct access to the founders for quick decisions.
How to Apply
Please send:
- Links to two projects (code or live sites) that show off your FastAPI + React skills
- A brief plan (5–7 bullets) for how you’d tackle this project’s V1 scope.
- Your availability, timezone, and compensation proposal. Please provide a total fixed-fee quote for the V1 scope and the estimated number of hours you expect it will take.
Compensation
This is a fixed-fee project with a budget of $2,000–$5,000 for the V1 milestone. The hourly rate in the job summary is an estimate for LinkedIn's UI. We are interested in your total fixed-fee quote for the scope.
All backgrounds are welcome. We care about what you can ship.
