AdoptAnOrganizer

The zero-cost, AI-assisted playbook for building your Minimum Viable Product (MVP).

0. Your Core Resources

Keep these links handy. You will feed them to the AI so it understands your vision.

1. The Setup

You do not need to install anything or hire a developer. We will use a free, browser-based AI coding assistant to write and host the code for you.

  1. Navigate to Bolt.new (or a similar tool like Lovable.dev).
  2. Create a free account.
  3. Start a new blank project.
  4. Follow the sequential prompts below. Do not skip steps. Let the AI finish generating the code for one prompt before pasting the next.

2. The Execution Loop

Step A: Establish the Brain (Database & Scope)

This forces the AI to read your documents and build the underlying database without getting distracted by future feature ideas.

I am building the MVP for a platform called AdoptAnOrganizer (AAO). I have 4 core documents outlining the platform.

Here are the links to my context:
1. Concept: https://docs.google.com/document/d/1sbywuqqkFXU2QENCxKfK839ggsAvnh_5Bt8iWFBDdcs/edit
2. Specs: https://docs.google.com/document/d/1hYDbaVWLAyqT_nBUWGRhsO64OFrFKMpaHrymyYThWHU/edit
3. Architecture: https://docs.google.com/document/d/1s7tCbooeSYnH6_JhzLRMn0_Pqw5gh6cKQizUok-Y9No/edit
4. Design: https://docs.google.com/document/d/1_nrEvJPnQATPQK_00ezUwtklthM9CZhi2_34AB0WBM4/edit

Task 1: Read these documents. Enforce a strict feature freeze. We are ONLY building three things:
1. Organizer Trust Verification
2. Housing/Couch Donations
3. Matching Funds Allocation ($800-$1250 tiers)

Task 2: Build the database schema (Users, Roles, Housing Offers, Fund Matches) based on the "Social Movement Platform V2" shared-database architecture concept. 
Build the backend first. Do not build the UI yet.

Step B: Build the Trust Engine

The most important part of the app is psychological safety for donors and hosts.

The backend looks good. Now, let's build the frontend UI for the **Organizer Trust Verification** flow.

Create a clean, minimalist interface. I need:
1. A view for an aspiring organizer to submit their verification details.
2. A public-facing profile view where supporters can clearly see that verification status.

Reference the first 22 pages of the Design document to ensure the UI feels highly secure, legible, and trustworthy. Let me know when this is ready so I can test it in the preview window.

Step C: The Housing Board

Allows hosts to securely offer their space to verified organizers.

Next, build the **Housing/Couch Donation** view. 

Requirements:
- A Host must be able to list a temporary space.
- This listing system must link directly to the verified organizer profiles we just built. 
- A Host must be able to see the Organizer's verification status before accepting.
- Hide exact addresses for privacy until a match is confirmed.

Implement this flow and update the UI.

Step D: The Money Matches

The final core pillar for wealthy progressives to distribute funds.

Finally, implement the **Matching Funds Workflow**.

Requirements:
- Create a dashboard for a 'Funder' user role.
- They need to see a queue of verified organizers who have met their initial community support goals.
- The interface must clearly display the required matching funds tier ($800 to $1,250) based on the organizer's city tier.
- Add a simple "Approve Match" workflow.

Your Project's Brain: NotebookLM

Before you write any code, you need a thinking partner. Google NotebookLM is a free AI tool designed to ingest your project documents and become an absolute expert on your vision.

How to set it up:

  1. Go to NotebookLM and create a new notebook called "AdoptAnOrganizer".
  2. Upload all four of your core reference documents linked above.
  3. Use it as your sounding board: If you get stuck, aren't sure how a feature should work, or need to summarize the requirements for the coding agent, ask NotebookLM. It will answer using only your uploaded documents, ensuring you stay perfectly aligned with your original goals.

Other Essential Tools for the Unknown

When you aren't sure what you need yet, these tools help bridge the gap between an idea and an execution:

  • ▹
    v0.dev (Visualizing interfaces): If you are struggling to picture what the Trust Verification dashboard should look like, type your idea into v0. It generates clean, modern UI designs instantly. You can then show that design to your coding agent to copy.
  • ▹
    Claude (The Debugger): If your coding agent gets confused by a massive error and the "Emergency Fix" prompt isn't working, paste the error into Claude. It is incredible at explaining complex code breaks in plain English so you can direct your agent on how to fix it.
  • ▹
    Excalidraw (Mapping it out): A perfectly minimalist digital whiteboard. When you need to visually map out how a donor connects to an organizer before you prompt the AI, sketch the flow here first.

Emergency Fixes

If the AI breaks the app or gives you an error screen, do not panic. Just paste this into the chat:

The app broke and is showing an error. Please undo your last change, analyze why it failed, and try a safer approach to implement the feature.